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Crea, sviluppa e vendi 
gli oggetti che popolano 
l'universo digitale 

|/le basi usa subito il Linden 
Scripting Language e l'ambiente 
di sviluppo 

•hello world disegna il tuo 
primo oggetto e fallo parlare 
quando lo tocchi con il mouse 

il movimento fai spostare 
le tue creazioni, seguendo 
fedelmente le leggi della fisica 

•effetti composti metti insieme 
più oggetti e animali in sincronia 

PROGRAMMA IL 

Con Microsoft Studio Robotics bastano pochi click di mouse per progettare 
un sistema completo e simularne il comportamento prima di assemblare i pezzi 



TRACCE ISO DAI 
NOSTRI PROGRAMMI 

Leggi e crea i dati in formato CD 
o DVD direttamente dal tuo software 



EFFETTI SPECIALI 

PER LE APPLICAZIONI 

Crea interfacce grafiche 
sofisticate con le Swing Bug 



JAVASCRIPT 



trasformazioni 
xslt lato server 

Stessi dati, output diverso. 
Basta cambiare pochi parametri 



SOLUZIONI 



ALGORITMI DI SCHEDULING: QUANDO VUOI 
PROGRAMMARE UNA SERIE DI ATTIVITÀ CI SONO MOLTE POSSIBILI 
SOLUZIONI, ECCO QUELLE PIÙ EFFICACI 




Ecco come monticare 
H formato! 



DAI UNA CACHE 
AL TUO SOFTWARE 

Quando i dati sono tanti, 
ecco le tecniche per ottenere 
comunque prestazioni elevate 

GRANDE FRATELLO 
CON IL GPS 

Ricevi le coordinate e mostra 
la posizione dell'apparecchio 
su una mappa di Google 



JAVASCRIPT 



FRAME NASCOSTI 
QUASI COME AJAX 

Sfrutta gli Hidden frame. Ottimizza 
il caricamento delle pagine ed aggira 
il problema del reload 



CORSI BASE 



• WxWidgets 

Il posizionamento 
dei controlli 

• PocketPC 

Programmazione 
degli Smartphone 

• Java Server Faces 

Gestione dei dati 
attraverso JDBC 

• UML Cosa sono 

e come funzionano 
i diagrammi di stato 
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ABBONAMENTO E ARRETRATI 
ITALIA: Abbonamento Annuale: I0PR0GRAMM0 (11 NUMERI) €59,90 
SCONTO 21% SUL PREZZO DI COPERTINA DI €75,90 ■ I0PR0GRAMM0 
CON LIBRO (11 NUMERI) €75,90 SCONTO 30% SUL PREZZO DI COPER- 
TINA DI €108,90 OFFERTE VALIDE FINO AL 30/11/07 



spese (spedizione con corriere). Prima di inviare i pagai 
verificare la disponibilità delle copie arretrate allo 02 831212. 



dovrà essere inviata via fax allo 02 83121206, oppure via posta a EDI- 
ZIONI MASTER via C. Correnti, 1 - 20123 Milan ' 
il pagamento, secondo le modalità di seguito elencate: 
• cc/p n.16821878 o vaglia postale (inviando copia della ricevuta del 



assegno bancario non trasferibile (da inviarsi in busta chiusa 
i richiesta); 
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• bonifico bancario intestato a Edizioni Master S.p.A. c/o BCC MEDI0C- 
RATI S.C.AR.L. c/c 000 000 12000 ABI 07062 CAB 80880 CIN P (invian- 
do copia della distinta insieme alla richiesta). 
SI PREGA DI UTIUZZARE IL MODULO RICHIESTA ABBONAMENTO POSTO 
NELLE PAGINE INTERNE DELLA RIVISTA. L'abbonamento verrà attivato sul 
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in edicola e nei punti vendita autorizzati, facendo fede il timbro 



Inviare il CD-Rom difettoso in busta chiusa a: 



atei. 02 831212 



i: Arti Grafiche Boccia S.p.a. Via Tib 



ii&CS.p.A. 
.io, 81 - Roma 
il mese di Settembre 2007 

e in alcun modo riprodotta ser 
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derivanti da virus informatici non riconosciuti dagli antivirus ufficiali 
all'atto della masterizzazione del supporto. Nomi e marchi protetti sono 

citati senza indicare i relativi brevetti. 
1 Anno di Computer Bild 2006, 1 Anno di lo Programmo in DVD 2006, 1 
Anno di Linux Magazine in DVD 2006, 1 Anno di Office Magazine 2006, 

lAnr- -•"••" --— — — ----- ■■ -•—..-- 

Bild Italia, Auto Interactive, Calcio & Scommesse, Carlo Verdone 
Colli -■■ " 

Magazine, Digital Music, DVD Magazine, DVD Magazine Films, Family 
DVD Games, Filmteca in DVD, Frank Sinatra Collection, Fred Astaire 
Collection, Futurama Collection, GoiOnLine Internet Magazine, Home 
' "--■- ' "—•■-•■ •-• " "cai, I DVD di 

Quale Computer, I DVD di Win Magazine, I DVD de La Mia Barca, I Film di 
' '" """ ! -li in DVD, I Film di DVD M — 
Barca, I Grandi Giochi per Pc, I Libri di Quale Computer, I Mitici all'Italiana, 

' "• b. Idea Web Film, Ini — 

Magazine, lapan Cartoon, Jerry Lewis Collection, La mia Barca, La mia 
Videoteca, Linux Magazine, Miami Vice in DVD, Office Magazine, Play 
Generation, Play Generation Games, Play Generation Plus, Play 
Generation Guide e Trucchi, PC Iunior, Quale Computer, Sol 
World, Sport Life, Star in DVD, Video Film Collection, Win junior, Win 



Collection, Le Collection. 
"Rispettare l'uomo e l'ar 
tutto dò che facciamo e di ogni decisione che prendiamo per assicurare 



performance ambientali e sulla prevenzione dell'inquinamento" 
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Questo mese su ioProgrammo 



NUOVI MERCATI 



Chi legge ioProgrammo da qualche anno è abituato al 
carico di innovazione tecnologica che abitualmente 
presentiamo in queste pagine, così che spesso risulta 
difficile fare una pausa di riflessione e riaggregare la 
pura tecnica in termini di spinta di mercato. Eppure 
in questo numero appaiono evidente tre linee guida: 
scripting embedded, automazione robotica, pro- 
grammazione dei device mobili. Se la terza, appare or- 
mai lontana dall'essere una novità, rimane comunque 
un mercato affascinante per le potenzialità ancora non 
completamente espresse che la miniaturizzazione del- 
le apparecchiature di comunicazione può offrire. La 
mobility rappresenta senza dubbio un futuro non lon- 
tano e anche se lentamente, la convergenza fra appli- 
cazioni desktop e mobile sembra offrire numerosi 
sbocchi a noi programmatori. D'altra parte gli altri due 
temi rappresentano invece una novità assoluta. Da un 
lato parliamo di programmazione embedded all'in- 



terno di un mondo virtuale, dall'altro questo tipo di 
tecnologia può essere facilmente espansa per ab- 
bracciare tipologie di programmazione più generali. 
Pensate alla programmazione di plugin per i videoga- 
me ma anche allo sviluppo che un vostro software po- 
trebbe avere se dotato di un linguaggio di program- 
mazione interna. Qualunque vostra applicazione po- 
trebbe ottenere un enorme vantaggio se concepita con 
una tecnica del genere. Allo stesso modo esistono già 
software conosciutissimi per i quali è possibile svi- 
luppare plugin utilizzando un linguaggio di scripting 
embedded, pensate a World Of Warcraft come a Pas- 
spartout per citarne solo un paio. Il terzo tema che af- 
frontiamo in questo numero è invece un assoluta no- 
vità. Si tratta di applicare i concetti di drag & drop dei 
componenti alla robotica. Si certo siamo ancora lon- 
tani dalla progettazione di un robot per l'utente co- 
mune, ma neanche poi tanto. 




rj cd rj web 

nome_file.zip 



All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 




Il tuo codice su 

r ^M&m 



^^ 



\i il 



y 



-J 



Crea, sviluppa e vendi 
gli oggetti che popolano 
l'universo digitale 

LE BASI: usa subito il 
Linden Scripting 
Language e l'ambiente 
di sviluppo 

HELLO WORLD: disegna 
il tuo primo oggetto 
e fallo parlare quando 
lo tocchi con il mouse 



IL MOVIMENTO: fai spostare le tue 
creazioni, seguendo le leggi della fisica 

/ / 



EFFETTI COMPOSTI: metti insieme più oggetti 
e animali in sincronia 
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CREA IL TUO ROBOT 
A COLPI DI CLICK 

Microsoft ha appena presentato il suo "Visual Studio Robotics", il primo 
ambiente RAD e visuale per lo sviluppo rapido di applicazioni destinate 
all'automazione robotica. Ecco come installarlo e usarlo facilmente 

pag. 24 



IOPROGRAMMO WEB 



Trasformazioni XSLT lato server 
pag. 30 

XSLT consente di ottenere un documento 
in un qualunque formato a partire da una 
base XML. Ad esempio dagli stessi dati si 
può ottenere un file PDF oppure un file 
DOC. Impariamo come integrare questa 
tecnica con i linguaggi più comuni 

Creare report excel dal web 
pag. 37 

Esportare i dati di output dalle nostre 
applicazioni in comodi file excel è sempre 
stato molto utile se non essenziale. Con 
le giuste librerie ora è ancora più facile, 
utiliziamone una, semplice e gratuita 




GRAFICA 



Effetti speciali per le applicazioni 
pag. 37 

Impariamo come utilizzare le API di 
Swing-Bug per realizzare applicazioni 
desktop dotate di interfacce grafiche 
avanzate e dotate di animazioni decisa- 
mente insolite per software sviluppato in 
Java 

Gestione dei dati con i frame 
pag. 40 

// collegamento XMLHTTPREQUEST non è il 
solo modo di reperire i dati da elaborare in 
Javascript vedremo all'opera una tecnica 
che ci consente di fare a meno del lato ser- 
ver e di progettare applicazioni off-line 



MOBILE 



Grande fratello 
con il GPS 
pag. 48 

Ecco come usare il supporto al GPS di Windows 
Mobile 5 ed inviare la nostra posizione ad un 
server Web che, tramite l'uso dei servizi messi 
a disposizione da Google Maps o Microsoft 
Virtual Earth, la traccia su una mappa 

VB.NET per mobile elementi 
variabili 
pag. 56 

Perchè utilizzare un software esterno per 
masterizzare i dati? Creiamo un'applicazio- 
ne in grado di gestire le tracce ISO. 
Usiamole come se fossero una parte del 



nostro File System, in modo del tutto tra- 
sparente 



SISTEMA 



Dai una cache al tuo sotware 
pag. 64 

Le applicazioni non sono mai abbastanza 
veloci. Le tecniche di caching sono uno dei 
metodi principali per aumentarne le perfor- 
mance. Impariamo ad utilizzare il Caching 
Application Block con Microsoft Visual Studio 

XPS: l'alternativa Microsoft al PDF 
pag. 70 

Oltre alle migliaia di funzionalità rivolte all'a- 
spetto grafico, Windows Presentation 
Foundation, ci mette a disposizione una serie 
di servizi rivolti alla gestione dei documenti. 
Integriamo il nuovo XPS nel nostro software 

Infrastruttura dei sistemi virtuali 
pag. 104 

/ nostri giorni vedono la presenza di un eleva- 
to numero di sistemi operativi dispersi in dif- 
ferenti versioni. Per non incorrere in problemi 
è importante testare il nostro software su più 
tipologie di installazione, ma come fare? 



CORSI BASE 



Posizionamento dei controlli . . pag. 80 

Come creare applicazioni che scelgono la 
posizione dei componenti sulla base della 
risoluzione del sistema o della finestra grafi- 



RUBRICHE 



Gli allegati di ioProgrammo 

pag. 8 
// software in allegato alla rivista 

Il libro di ioProgrammo 

pag. 6 
// contenuto del libro in allegato 
alla rivista 

News pag. 12 

Le più importanti novità del 
mondo della programmazione 

Software pag. 107 

/ contenuti del CD allegato ad 
ioProgrammo. 



ca? Ecco le tecniche per non dover mai ricor- 
rere a form non ridimensionabili 

Sfuttare tutte le risorse 
pag. 86 

VB.NET e gli strumenti RAD che Microsoft 
ha reso disponibile per la program- 
mazione dei dispositivi mobili rendono lo 
sviluppo di un'applicazione un'oper- 
azione non difficile. Ma come fare per 
ottenere le massime prestazioni? 

Gestione 

dei dati attraverso JDBC 
pag. 92 

La rappresentazione dell'informazione è 
solo uno dei tanti aspetti nella proget- 
tazione di un'applicazione. Un ruolo di 
fondamentale importanza viene rivestito 
dall'interfacciamento con i database. 
Ecco come fare... 

Diagrammi di stato .... pag. 100 

Abbiamo imparato come modellare 
un'applicazione e a rappresentare il flus- 
so delle operazioni. Possiamo adesso 
identificare in che condizioni si trova 
l'applicazione in un preciso istante? La 
risposta è si. Ecco come 



SOLUZIONI 



Programmazione delle attività 
pag. 111 

Dovete raggiungere un obiettivo. Per 
farlo avete necessità di organizzare una 
serie di compiti ed assegnarli a diverse 
persone. Ci sono milioni di modi di rag- 
giungere lo scopo. Ma qual è quello più 
efficace? 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di 
essere comprensibili a tutti coloro 
che ci seguono. Nel caso in cui 
abbiate difficoltà nel comprendere 
esattamente il senso di una 
spiegazione tecnica, è utile aprire 
il codice allegato all'articolo e 
seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. 
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http://forum.ioprogrammo.it 
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I contenuti del libro 
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Internet nel corso del tempo ha modificato la sua fisionomia. 
Siamo passati da una struttura in cui i collegamenti fra i 
diversi contenuti presenti in rete erano realizzati con Link, ad 
una infrastruttura in cui tutto è interconnesso tramite API. Ad 
esempio è possibile localizzare la posizione di un sito tramite il 
suo indirizzo IP e mostrarne la locazione geografica su Google 
Maps. Oppure è possibile utilizzare Flickr come deposito per le 
immagini da visualizzare sul proprio Blog sfruttandone tutta la 
potenza dei tag. E ancora gli RSS consentono di integrare fra di 
loro contenuti diversi riaggregandoli in molteplici forme. Anche 
la programmazione tradizionale trae beneficio da queste 
innovazioni. È oggi possibile creare applicazioni che sfruttino 
pesantemente le migliaia di API esposte su Internet. In questo 
libro, ricco di esempi, vengono presentate alcune delle API più 
famose e viene illustrato un percorso che mette in grado il 
programmatore di cominciare a pensare in modo distribuito. U 
n Hand Book essenziale 



MASHUP: OVVERO COME 
INTEGRARE I SERVIZI OFFERTI DA 
GOOGLE, MICROSOFT, TECHNORATI, 
FLICKR E GLI ALTRI ALL'INTERNO 
DELLE PROPRIE APPLICAZIONI 

• I linguaggi e la loro interazione 
con i Web Services 

• Gli esempi con Google, Flickr, 
Technorati... 

• Accesso diretto alle risorse Web 
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RIVISTA + CD-ROM 
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L'editor "ufficiale" per PHP 

PHP è uno straordinario linguaggio di 
programmazione che ha dalla sua 
parte una completezza fuori dal 
comune, una curva di apprendimento 
bassissima, una velocità d'esecuzione 
non facile da trovare in un linguaggio 
interpretato. Normalmente si può scri- 
vere codice php persino utilizzando il 
notepad, ma ovviamente utilizzare un 
editor con caratteristiche avanzate 
migliora di molto la velocità di coding di qualunque pro- 
grammatore.Zend Studio è un editor decisamente completo 
prodotto dalla software house che più di ogni altra sponso- 
rizza lo sviluppo di PHP. Le funzionalità inserite sono tantis- 
sime, dalla navigazione fra le classi, al code complexion, 
alla sintax highliting, al tracing e al debugging dell'applica- 
zione. Utilizzare questo strumento migliora facilita enor- 
mente la stesura del codice a qualunque programmatore. 



-e- 



Come usare l'interfaccia del CDRom 



IL SOFTWARE 



Una accurata recensione 
dei contenuti 




Il top software del mese 
individuato dalla redazione 



IL SOFTWARE 



Il software diviso 

in categorie per 

una comoda consultazione 



CONTATTACI 



i i-HilHH*i 



L'elenco del software 
contenuto nelle categorie 



DIMENSIONE 



La dimensione 
del software sul CD 



Vuoi inviare una email alla 
redazione con le tue richieste 



I siti più interessanti 
del mese selezionate 
per te 



RICERCA SOFTWARE 



Il database di tutti i software 
pubblicati da ioProgrammo 
anche gli arretrati 



Clicca qui per installare o 
salvare il software sul tuo PC 



Abbonamenti informazioni 
e servizi utili 



<-y 
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Online con Tiscali Easy 

Numero unico per tutta l'Italia e nessuna registrazione. Il modo 
più semplice e veloce per entrare in Internet risparmiando 



-e- 



Sei spesso lontano da casa e hai necessità di 
collegarti a Internet ovunque ti trovi? 
Desideri salvaguardare la tua privacy navigan- 
do in modo anonimo? Non hai voglia di perde- 
re tempo in lunghe registrazioni per creare un 
nuovo account? Niente paura, Tiscali ha pensa- 
to anche a te! Con Tiscali Easy arriva un siste- 
ma tutto nuovo di collegarsi a Internet. Non 
sarà più necessario creare un nuovo account e 
fornire i propri dati personali, potrai navigare 
collegandoti con un unico numero di telefono 
(7023456789) da tutta Italia e soprattutto utiliz- 
zando i dati di accesso forniti direttamente da 
Tiscali (UserID e Password presenti sulla sche- 
da), quindi non collegabili in alcun modo a te. 
Insomma, con Tiscali Easy, otterrai in un colpo 
solo riservatezza dei dati, risparmio del tempo 
necessario alla creazione di un abbonamento e 
tariffe vantaggiose. I costi di connessione sono 
simili a quelli di un classico abbonamento gra- 
tuito: 1,90 cent, per i primi 10 minuti e 1,72 
cent, per quelli successivi. Per risparmiare 
ulteriormente è possibile connettersi a 
Internet durante le ore serali o nei giorni festi- 



r 



TISCALI EASY 



C'È UN MODO NUOVO, SEMPLICE E VELOCE PER ENTRARE IN INTERNET. PROVALO SUBITO! 

_^^^^^^^^^_ Crea una nuova connessione inserendo il numero 

unico di accesso da tutta Italia 7023456789 



L'ACCESSO 

PIÙ* 

SEMPLICE 

A» 

INTERNET! 



30€fciSffi8 



Avvia la connessione e digita i seguenti codici: 

UserID master2007 
Password tiscali 

Grazie per aver scelto Tiscali 
e buona navigazione! 

Costi di connessione disponibili su tiscali.it 
I Servizio di Assistenza dedicato 166614161 



V. 



tiscali* 

INTERNET WITH A PASSION. 



vi al costo di 1,09 cent, per i primi dieci minuti 
e 0,98 cent, per quelli successivi. L'unico requi- 
sito richiesto per poter eseguire la connessione 
è un modem correttamente installato. Poiché 
si tratta di una normale connessione analogica 
è possibile utilizzare i tool di accesso remoto 
integrati in Windows 



■e- 



IN RETE CON TISCALI 



Nessuna registrazione basta creare una nuova connessione e inserire 
i dati di accesso forniti da Tiscali 



File Modifica | "jmenti Avanzate ? 

j Indietro - ^ j Cerca Cartelle [7[[| - 




Q NUOVA CONNESSIONE 
Portiamoci nel pannello di con- 
trollo, e selezioniamo l'icona connes- 
sioni di rete. In alto a sinistra sele- 
zioniamo "nuova connessione" e 
prepariamoci a seguire il wizard che 
comparirà 



Informazioni sull'account Internet 

*-_ r,:.:i.::aiii. i oc, ■: i'« ncr,.,. j-_<_ .«>,.' e 
all'account Internet. 


cedere w^mÌM 


irnriieKeie un nome di & 
sono state dii i 
Nome utente: 
Password: 
Conferma pe 
Utilizza qu 

Imposta qi ' 


1 li - 1 li , i II 1 |H( jl | l- <-|- t,iil j -,1' 

i i 1 i r i i ii 1 p ii 
;ontattare l'ISP. 
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ie: Morir Interne' rome prjdernìiia 








< Indietro Avanti > ] Annulla | 



BDATI DI ACCESSO 
Seguiamo il Wizard fino a 
quando non ci vengono chiesti i 
dati per l'autenticazione. E' suffi- 
ciente inserire quelli presenti nella 
card allegata a questo numero di 
ioProgrammo: master2007/tiscali 




H ACCESSO A INTERNET 
Connettersi è semplicissimo, 
troveremo una nuova icona all'in- 
terno del pannello di controllo alla 
voce connessioni. Bastano due click 
ed il gioco è fatto sarete connessi 
ovunque vi troviate 
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UNO SGUARDO ALLA 
ETECH DI SARI DIEGO 
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IBM: SCIOPERO 
VIRTUALE 

In un'epoca in cui reale e virtuale con- 
vergono in mondi paralleli è lecito 
attuare una protesta addirittura met- 
tendo in sciopero i residenti del mon- 
do di Second Life. I primi a muoversi in 
questa direzione potrebbero essere i 
dipendenti deM'IBM di Vimercate in 
segno di protesta verso il fallimento del- 
la trattativa per il contratto interno 
integrativo. E così invece di chiudere 
i cancelli e attuare la protesta a mez- 
zo dello stop lavorativo, i dipendenti 
di IBM avrebbero scelto la via del vir- 
tuale. Lo sciopero non è però soltan- 
to simbolico. IBM infatti risulta come 
una delle aziende che maggiormente 
ha investito nel mondo ideato da Lin- 
den. Uno sciopero dei propri dipen- 
denti su SL significa comunque attuare 
una protesta significativa anche a pro- 
posito del danno economico. 
In ogni caso questa vicenda sta for- 
nendo una certa visibilità proprio agli 
investimenti che IBM ha fatto in que- 
sto settore. Sono proprio certi i di- 
pendenti di IBM che non stiano, in fon- 
do, facendo una cortesia alla propria 
azienda? 

ADDIO PHP 4 

opo anni e anni di gloria, il vecchio 
PHP4 è stato messo nel cassetto 
dal suo team di sviluppo. Ufficialmen- 
te il supporto verso PHP 4 continuerà fi- 
no alla fine di quest'anno ma tuttavia 
non ci saranno più nuovi rilasci di que- 
sta serie del linguaggio di scripting. Le 
motivazioni sono ovvie. PHP5 è ormai 
sul mercato da quasi 3 anni e PHP6 è 
in via di sviluppo. Il team di PHP ritie- 
ne che la versione 5 del linguaggio sia 
stabile e matura per cui non ci sono più 
ostacoli alla migrazione. Per tutti co- 
loro che utilizzano ancora la vecchia 
gloriosa versione 4 è stato reso dispo- 
nibile un link con una serie di istruzio- 
ni per una facile migrazione. Chi vo- 
lesse consultarlo può trovarlo all'indi- 
rizzo: http://www.php.net/manual/ 
en/migration5.php. Per la migrazione 
delle migliaia di applicazioni che sup- 
portano ancora PHP4 è invece utile con- 
sultare i link dei singoli sviluppatori. 
Raramente ne troverete di non migra- 
bili. 




Conoscere il futuro è impossibile ma gettare 
uno sguardo sulla tecnologia futura, presen- 
tata da ricercatori d'avanguardia è che siano 
scienziati, sviluppatori di prodotti, capi d'a- 
zienda, profeti della tecnologia, scopritori di 
talenti, hacker o investitori di capitali è cer- 
tamente possibile. Il 3-6 marzo 2008 a San 
Diego, in California, si terrà la quinta confe- 
renza "Etech: Emerging Technologies", orga- 
nizzata da O'Reilly Media (http://conferen- 
ces.oreillynet.com/et2008/), che anche que- 
st'anno si propone di discutere o di offrire la 
risoluzione di un problema personale, col- 
lettivo o planetario attraverso nuove solu- 
zioni tecnologiche, è invitato a partecipare, pre- 
sentando delle relazioni o tenendo dei tuto- 
rial, chiunque voglia dire in pubblico cosa 
sta risolvendo nella propria vita la tecnolo- 
gia o cosa vuole che risolva; gli hacker che 
stanno lavorando a un progetto "che salverò 
il mondo o il tuo business, o semplicemente 
il tuo tempo"; chiunque voglia dimostrare 
in che modo la tecnologia porti alla felicità o 
ci scaraventi nelle situazioni che più temia- 
mo. Gli sponsor della conferenza, oltre al pa- 
drino di Web 2.0 Tini O'Reilly e la sua quasi ven- 
tennale azienda, punto di riferimento e am- 
plificatore dei nuovi trend tecnologici che 
vengono dagli "alpha geek" di tutto il mon- 
do, sono Amazon, Adobe, Microsoft, Mozil- 
la, Sun, Yahoo! e altri, fra cui Walt Disney II 
direttore del programma Brady Forrest ha 
ampliato gli argomenti proposti per il 2008 
rispetto alle edizioni passate. Ha dichiarato: 
"Stiamo espandendo lo scopo di Etech, guar- 
dando oltre al mondo del Web a tutto quello 
che è manifattura, biotecnologia, sistemi su 
larga scala, giochi virtuali, visualizzazioni, 
robotica, politica, il miglioramento dell'uomo 
in generale e la tecnologia pulita". Questo al- 



Enrica Garzilli 

largherà la base dei partecipanti dai circa 
1000 usuali ai previsti 1200. Gli anni passati 
hanno visto presentare o perfezionare pro- 
getti quali quello del Dipartimento della di- 
fesa americano, che ha creato un sistema di 
simulazione della terra chiamato Sentient 
World Simulation al fine di prevedere vari 
scenari possibili sul nostro pianeta come, per 
esempio, per quanto tempo un essere uma- 
no puè resistere senza viveri o come una per- 
sona qualunque può rispondere a un bom- 
bardamento massiccio di propaganda televisiva 
SWS non rappresenta solo un mondo vir- 
tuale completo, con tutte le situazioni uma- 
ne possibili, ma è calibrato secondo dati trat- 
ti dal mondo reale quali le notizie politiche 
pie importanti, i risultati dei censimenti, gli 
indicatori economici e le variazioni climati- 
che, insieme alle informazioni segrete di agen- 
zie come quelle dei servizi segreti militari. 
Dai progetti grandiosi e istituzionale a quel- 
li del singolo. L'anno scorso un hacker ha da- 
to le istruzioni per creare una macchina CNC 
(Computer Numerical Control) a tre assi "in 
modo semplice ed economico", cioè per fare 
da soli un controllore di computer che tra- 
duce le istruzioni numeriche di un codice in 
movimenti per guidare uno strumento che 
fabbrica componenti metallici. Quest'anno, 
gli argomenti suggeriti per l'edizione 2008 ai 
potenziali relatori rappresentano delle vere e 
proprie sfide agli specialisti di tecnologie a 
qualsiasi livello. Uno dei temi è come porta- 
re avanti la causa del risparmio, della con- 
servazione e della rigenerazione dell'ener- 
gia del pianeta; un altro è il miglioramento 
dell'umanitè e il "body hacking", cioè cosa 
stanno facendo hacker, forze armate e indu- 
stria privata per estendere le abilità fisiche e 
mentali con tecnologie miniaturizzate. Un 
tema decisamente provocatorio si intitola 
"Steal from the seedy" cioè, letteralmente, 
"Rubare dal degradato": cosa possiamo im- 
parare dalla tecnologia piò avanzata del por- 
no, delle forze armate, deibotnet, degli spam- 
mer e persino di Al Qaeda? In altre parole, 
come possiamo usare per scopi "puliti" quel- 
lo che è nato essenzialmente come minac- 
cia alla legalità o come anti-terrorismo infor- 
matico? Tutti i partecipanti e le idee che aiu- 
tano a prepararsi per creare un domani mi- 
gliore attraverso la tecnologia sono benve- 
nuti a Etech 2008. 
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SERVICE PACK 1 IN VISTA 



-0- 



E così siamo quasi pronti per il primo service pack uf- 
ficiale di Windows Vista. Microsoft ha schedulato il 
rilascio del SP1 nei primi 4 mesi del 2008. Ma già i rumors 
sul suo contenuto si susseguono e c'è già qualcuno che 
giura che sia disponibile in modo illegale sui circuiti di 
P2P. 

Ma che cosa conterrà il nuovo i-t 

service pack e quali sono le no- 
vità che gli utilizzatori e i siste- 
misti dovranno aspettarsi? La ri- 
sposta più generica possibile è: 
miglioramenti dal punto di vi- 
sta qualitativo, un maggiore sup- 
porto Hardware e agli standard, 
l'inserimento di una nuova tec- 
nologia denominata ESO - Ex- 
tensible Firmware Interface, una 
nuova funzione per la gestione 
delle tabelle d'allocazione del 

file system: Extended File Allo- 

cation Table. Per gli ammini- 
stratori di sistema è previsto un miglioramento dei tool 
di deframmentazione e di quelli relativi alla diagnosti- 
ca della rete. 

Un significativo miglioramento in termini di sicurezza po- 
trebbe provenire da Bitlocker, un tool per cryptare le 



partizioni con caratteristiche piuttosto avanzate. Il rilascio 
di un nuovo Service Pack a così breve tempo dall'usci- 
ta di Windows Vista ha provocato non poche reazioni 
nella community degli utenti. In realtà Vista si sta diffon- 
dendo a ritmi non elevatissimi anche se in modo co- 
stante. Il rilascio del nuovo SP non migliora la fiducia che 
1 gli utenti hanno nel nuovo OS. 



Tuttavia Microsoft non sembra es- 
: sere preoccupata dalle critiche 
che riguardano il proprio servi- 
zio di Update. Nelle dichiara- 
zione del management si legge 
entusiasmo riguardo alle tec- 
nologie che vengono adottate 
per la diffusione degli aggior- 
namenti, e anzi il servizio viene 
esaltato come sinonimo di pro- 
fessionalità e supporto. D'altra 
parte, i sistemi di Microsoft, non 
sono i soli a subire aggiorna- 
menti continui e l'utente do- 
vrebbe essere ormai abituato e anzi apprezzare questa 
volontà delle software house di mantenere costante- 
mente aggiornati i propri prodotti con tecniche non 
coinvolgono un dispendio di energie da parte dell'u- 
tente. 



LA LEGISLAZIONE ITALIANA SI APRE ALL'OPEN SOURCE 



In Italia si è aperto un vivace dibattito po- 
litico da quando agli inizi di giugno Bru- 
ce Perens e Richard Stallman, insieme al 
prof. Arturo di Corinto, hanno incontrato 
Fausto Bertinotti in una audizione ufficia- 
le della Commissione cultura della Camera 
dei deputati (http://www.news.rai.it/dl/por- 
tal/articolonews/Page-f7277efe-5f41-42f9- 
983b-2cl74df4c52c.html) . Infatti l'Italia sta 
preparando un progetto di legge che pre- 
vede il rilascio di programmi informatici li- 
beri nelle pubbliche amministrazioni e nel- 
l'istruzione. Perens, oltre ad essere uno dei 
principali portavoce del movimento Open 
Source, è consulente strategico e tecnico di 
Linux e Open Source Software per nume- 
rose aziende come IBM, NTT, Philips, NCR 
Corporation, Novell, Borland e altre picco- 
le aziende. Stallman è un programmatore 
che divenne il portabandiera del free softwa- 
re fondando nel 1985 la Free Software Foun- 
dation (FSF), una organizzazione senza fi- 
ni di lucro per lo sviluppo e la distribuzione 



di software libero ed è uno dei padri del con- 
cetto del copyleft. Con questo termine si in- 
dica un modello alternativo di gestione dei 
diritti d'autore basato su un sistema di li- 
cenze, quali la GPL per il free software o la 
Against DRM License per i lavori artistici 
(pubblicata dalla Free Creations), attraver- 
so le quali il detentore originario dei diritti 
sull'opera, che di solito è l'autore, indica ai 
fruitori dell'opera che essa può essere uti- 
lizzata, diffusa e spesso anche modificata 
liberamente, pur nel rispetto di alcune con- 
dizioni essenziali. 

Anche in rete e fra gli sviluppatori circola 
un grande dibattito sull'open source da 
quando il 29 giugno 2007 è stato rilasciata la 
versione 3 della GNU General Public Li- 
cense (GPL) (http://www.gnu.org/licen- 
ses/gpl.html), che regola la maggior parte 
dei prodotti open source. Lo scossone eco- 
nomico che la popolarissima filosofia del- 
la GPLv3 ha dato alle grandi multinaziona- 
li del software da una parte ne fa un nemi- 



co diretto, di cui devono tenere per forza 
conto e, dall'altra, ha concretizzato nel mon- 
do dell'informatica le parole di un detto in- 
diano: la conoscenza è una di quelle cose 
che, condivisa, cresce. 

Enrica Garzilli 
http://orientalia4all.net 
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SVILUPPA E VENDI 
SU SECOND LIFE 

IL METAMONDO PROGETTATO DA LINDEN LAB HA ASSUNTO DIMENSIONI ORMAI 
COLOSSALI. MILIONI DI PERSONE OGNI GIORNO COMPRANO E VENDONO OGGETTI 
IMMATERIALI. MA CHI LI PROGRAMMA? LA RISPOSTA È UNA SOLA: VOI! 
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REQUISITI 
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,-~ Sintassi linguaggi "C- 
1 ///re" 



Client Second Life 



00000 



Tempo di realizzazione 



Ammettiamolo, ognuno di noi progettisti 
è rimasto affascinato dal mondo virtuale 
rappresentato nella trilogia di Matrix. I 
più attempati ricorderanno, inoltre, dei film 
"Tron" in cui un programmatore, un tal Flynn, 
veniva "inglobato" all'interno di un mondo vir- 
tuale e combatteva al fianco di due "personaggi" 
(Ram e Tron, appunto) per la propria sopravvi- 
venza. 

Ebbene ancora una volta possiamo affermare 
che la fantascienza può diventare realtà, infatti 
nell'articolo che stiamo per leggere, andremo ad 
esplorare un nuovo mondo rappresentato tra- 
mite realtà virtuale in tre dimensioni. Il suo 
nome è "Second Life" ed è raggiungibile all'indi- 
rizzo http://www.secondlife.com . Il fenomeno di 
Second Life è decisamente notevole e già si pos- 
sono trovare delle guide da leggere, per com- 
prendere a fondo il "nuovo mondo". 
Dato che siamo in un contesto di programma- 
zione è bene precisare però che il contenuto 
dell'articolo sarà prettamente tecnico, infatti, 
per animare tutto ciò che è presente in Second 
Life, è necessario produrre script nel linguaggio 
di programmazione Linden Scripting Language. 
In questo primo articolo affronteremo le basi 
del linguaggio ed analizzeremo alcuni esempi 
"reali". Ma cominciamo dall'inizio. 



COS'È SECOND LIFE? 

Prendendo in prestito la definizione che trovia- 
mo in una apposita sezione del sito del progetto 
( http://www.secondlife.com/whatis) , possiamo affer- 
mare che Second Life è: "Un mondo virtuale 3D 
interamente costruito e posseduto dai suoi resi- 
denti". 

Detto in altri termini, Second Life (a cui, d'ora in 
poi, ci riferiremo utilizzando anche il termine 
"mondo") è come un immenso mondo costrui- 
to con dei "mattoncini" (ci ricordiamo dei vec- 
chi Lego?) in cui vivono i nostri alter- ego (gli 
"avatar" o "residenti" che dir si voglia). Tutto ciò 



che vedremo nel "mondo" è costruito a partire 
da componenti elementari (i "prim") e reso 
dinamico (vogliamo dire vivo?) utilizzando il 
linguaggio di programmazione che vogliamo 
cominciare ad esplorare: il Linden Scripting 
Language. 

Se vogliamo crearci una nuova vita virtuale, 
dobbiamo scaricare ed installare sulla nostra 
macchina un apposito programma client. 
Una volta installato il client e dopo esserci iscrit- 
ti a Second Life, possiamo iniziare la nostra 
avventura. 

Come detto, in questo ambito non ci sofferme- 
remo sui dettagli relativi alla "fruizione" del 
"mondo", quindi non descriveremo né i passi 
necessari per effettuare l'iscrizione, né tutti 
quegli aspetti che esulano dalla programmazio- 
ne del "mondo" stesso. Tutti i dettagli di cui 
sopra sono dettagliatamente illustrati (in ingle- 
se) nel sito di Second Life. 
Detto ciò, per entrare "in-world", lanciamo il 
client quindi forniamo le nostre "seconde" 
generalità (nome e cognome), la nostra pas- 
sword, quindi premiamo sul tasto "Connect..." 
(si veda la Figura 1). 




Figura 1: Siamo pronti per entrare in Second Life. 



Benvenuti in Second Life! Ciò che vediamo è il 
nostro avatar, che possiamo personalizzare nel- 
l'aspetto e possiamo muovere utilizzando le 
frecce direzionali della tastiera. Ma non distraia- 
moci troppo. 
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LA CASSETTA 
DEGLI ATTREZZI 

Visto che siamo qui per programmare, ci servo- 
no gli strumenti di sviluppo. Il client di Second 
Life contiene al suo interno tutto ciò che ci 
serve. Se facciamo clic sul bottone "Build" (in 
basso), il mouse si trasforma in "bacchetta 
magica"; se facciamo un clic sul terreno di fron- 
te a noi, ci appare un cubo di legno ed il relativo 
dialogo di progettazione; se facciamo clic sulla 
linguetta "Content", ci posizioniamo nella zona 
in cui porre i nostri script. Facciamo clic sul bot- 
tone "New Script ...": il sistema crea per noi il 
primo script, che possiamo analizzare se faccia- 
mo clic sulla relativa icona, così come mostrato 
in Figura 2. 
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F/gfiira 2: // nostro primo script 



Prima di addentrarci nell'analisi del nostro 
primo script, dobbiamo dire due parole sul 
Linden Scripting Language (che indicheremo 
sinteticamente con la sigla LSL, d'ora in poi), il 
linguaggio di programmazione del mondo vir- 
tuale. 



LINDEN SCRIPTING 
LANGUAGE 

La definizione di wikipedia per il LSL è: Linden 
Scripting Language is a state-event driven script- 
ing language, in the sense of a finite state 
machine. La cui traduzione ci fa capire esatta- 
mente con cosa avremo a che fare. Il LSL è un 
linguaggio per la programmazione di una mac- 
china a stati finiti guidata dagli eventi. Di ogni 
oggetto, infatti, noi dovremo programmare la 
sequenza degli stati che l'oggetto potrà assume- 
re, e gli eventi che verranno scaturiti dall/ nel- 
l'oggetto. La sintassi che regola il LSL è "C-like" 
quindi chi di noi sviluppa già in C# o in Java non 
avrà nessun problema a scrivere script. Accanto 
ai costrutti di base (cicli, variabili, funzioni defi- 
nite dall'utente, ecc.) il LSL offre una libreria di 
oltre trecento funzioni che ci consentono di 
manipolare (quasi) in ogni modo gli oggetti del 



"mondo". Chiaramente non avremo modo di 
illustrare tutte le funzioni disponibili; l'approc- 
cio dell'articolo è, invece, del tipo "hands-on- 
lab" ovvero analizzeremo esempi pratici per 
illustrare le possibilità del linguaggio in un con- 
testo "reale". 

Per capire a fondo il LSL, quindi, non ci resta 
che iniziare a programmare. 

HELLO AVATAR! 

Come per tutti i linguaggi di programmazione, 
anche per il LSL, il primo esempio di codice che 
si analizza è il classico "hello world!" che, nel 
contesto, assume la forma di "Hello Avatar!" (il 
codice è reperibile nel file Hello Avatar.lsl). Tra 
l'altro, a differenza degli altri linguaggi, l'am- 
biente di sviluppo ci aiuta, e ci compila già lo 
script (come mostrato nella Figura 2). 

default 

i 

state_entry() 

_C 

IISay(0, "Hello, Avatar!"); 

_} 

touch_start(integer tota l_num ber) 

_C 

IISay(0, "Touched."); 

_} 

} 



Se analizziamo il codice ci accorgiamo che è 
definito un solo stato, default, che è lo stato pre- 
definito e che deve essere SEMPRE presente in 
uno script LSL. 

Sono definiti due gestori degli eventi: 
state _entry e touch_start. Il primo evento viene 
scatenato quando si entra nello stato default, 
ovvero quando lo script viene complato; in que- 
sto caso, dato che non vengono definiti ulterio- 
ri stati, il codice del metodo state_entry viene 
eseguito solo la prima volta. Normalmente uti- 
lizziamo il metodo state_entry per inizializzare 




ITOR ALTERNATIVI 






DOWNLOAD 
& JOIN 

Il client di Second Life 
è scaricabile 
gratuitamente e per 
diversi sistemi 
operativi, a partire 
dall'indirizzo 
http://http://secure- 
webl 1 .secondlife.com/co 
mmunity/downloads.php 
mentre possiamo 
iscrivercial "mondo" 
a partire dall'indirizzo 
https://secureweb11. 
secondlife.com/join/ . 



Sebbene il client di SL consenta 
da solo di sviluppare codice, è 
interessante dare uno sguardo 
alla pagina 

http://lslwiki.net/lslwiki/wakka.php7w 
akka=AlternativeEditors dove sono 
elencati tutta una serie di editor 
installabili sulla nostra macchina 
ed utili per continuare a 
sviluppare anche in assenza di 
connessione al "mondo". 



Tra questi è da segnalare LSL- 
Editor che, tra l'altro, fornisce un 
"intellisense" tipo Visual Studio, 
colorazione del codice, e un 
debugger( http://www. lsleditor.org/) . 
Sebbene il programma non 
necessiti di installazione (basta 
scaricarlo, unzipparlo e lanciarlo), 
gira solo in ambiente Windows 
con .Net Framework versione 2.0, 
installato. 
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WIKI SU LSL 

La portata del 

fenomeno Second 

Life/Linden Scripting 

Language è 

dimostrata anche dal 

fiorire di siti "wiki" 

dove gli sviluppatori 

possono trovare una 

grande quantità di 

documentazione ed 

esempi. Tra questi 

sono da segnalare 

Second Life Wiki 

(http://wi ki .second I if e.co 

m/wiki/Main Page) e LSL 

Wiki 

(http://lslwiki.net/lslwiki/ 

wakka.php?wakka=Hom 

ePage) . 



l'oggetto quindi per valorizzare variabili globali 
piuttosto che per modificare l'aspetto dell'og- 
getto stesso. 

Restando nello stato default, il metodo 
touch_start viene eseguito ogniqualvolta viene 
toccato l'oggetto; per "reagire" al tocco utilizzia- 
mo una delle funzioni di libreria. Tutte le fun- 
zioni di libreria cominciano per "11" (che sta per 
"Linden Library"); la funzione USay viene utiliz- 
zata per comunicare con l'esterno (detto in altre 
parole per eseguire una azione di chat). Il primo 
parametro è il canale su cui viene inviato il mes- 
saggio che passiamo al metodo come secondo 
parametro. Ci sono ben 4,294,967,294 canali 
disponibili nell'intervallo che va da - 
2,147,483,648 a 2,147,483,647; il canale è Funi- 
co canale utilizzabile per mandare messaggi tra 
avatar e corrisponde alla chat. Tutti gli altri 
canali vengono utilizzati dagli script per la 
comunicazione tra oggetti (come vedremo più 
avanti). 

Ripartendo dalla Figura 2, se usciamo dalla 
modalità di progettazione dell'oggetto (clic 
sulla "x" in alto a destra del dialogo di progetta- 
zione) e facciamo clic sull'oggetto, ci accorgia- 
mo che, in effetti, nella zona in basso a sinistra 
appare il messaggio che ci invia l'oggetto. 




Object: Tcudwd. 
0b]«t; Touthed. 
Object: Toudted. 
Objert: Touched. 
Objtft: Touched* 
ObjHt: TtiUChtri. 
Objtft: wUCnffd. 



Figura 3: L'oggetto reagisce al tocco per mezzo delio 
script. 



mondo virtuale esistono le porte e, per aprirle e 
chiuderle, è necessario sviluppare del codice. Di 
seguito viene illustrato il codice per program- 
mare una porta scorrevole a chiusura automati- 
ca. In questo esempio di codice (reperibile nel 
file Porta Scorrevole. Isl) cominciamo a vedere 
l'uso degli stati e le varie transizioni. La porta 
può assumere quattro diversi stati; lo stato pre- 
definito (default) corrisponde alla porta chiusa. 
Dato che la porta non necessita di particolari 
configurazioni omettiamo il metodo state_entry. 
Decidiamo che la porta si deve aprire se la toc- 
chiamo (ovvero facciamo clic sull'anta). Il meto- 
do touch_start effettua una transizione di stato 
ponendo la porta nello stato "in apertura" 
(opening). Notiamo che sia per cambiare stato 
che per definire uno stato si usa la parola chiave 
state. 

default 

S 

// Evento scatenato dal tocco dell'avatar 

touch_start(integer total_number) 



{ 



// Cambiamo stato 



state opening; 



} 



> 



Dichiariamo un nuovo stato racchiudendo tra 
parentesi graffe ({}), i gestori degli eventi che 
interesseranno il nostro oggetto nello stato che 
stiamo definendo. 

Lo stato open ing rappresenta l'atto dell'apertura 
della porta. La porta resta in questo stato solo il 
tempo necessario alla sua apertura. Come pre- 
messa, dobbiamo precisare che le animazioni 
relative al cambio di posizione degli oggetti, 
sono eseguite automaticamente dal simulatore 
di Second Life. 



& 



UNA PORTA SCORREVOLE 

Cerchiamo di approfondire la nostra conoscen- 
za con un esempio più complesso. Anche nel 



E SAMDBOX 



Per i novizi, o comunque per 
coloro che non posseggono un 
proprio terreno in cui fare le 
prove, esistono delle zone 
franche, dette sandbox, in cui 
possiamo creare oggetti e 
provare i nostri script. Una di 
queste sandbox è raggiungibile 
al seguente indirizzo: Volksland 



9, 248, 21 (gli oggetti che 
creiamo vengono posti nella 
cartella "Lost And Found" del 
nostro Inventory, dopo alcuni 
minuti di utilizzo al fine di 
mantenere la sandbox "pulita" 
per continuare le nostre prove 
basta trascinare nuovamente 
l'oggetto sul terreno). 



// La porta si sta aprendo 



state opening 



{ 



state_entry() 



{ 



// Ricaviamo la posizione corrente della porta 



vector pos = IIGetPosQ; 



// Togliamo dalla componente trasversale la 

lunghezza della porta 



pos.y = pos.y - 2.000; 



// Imponiamo la nuova posizione 



NSetPos(pos); 



// Cambiamo stato 



state open; 



} 
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Per lo stato opening dobbiamo codificare solo il 
metodo state _entry in cui, innanzitutto, andia- 
mo a ricavare la posizione corrente della porta 
attraverso la funzione di libreria UGetPos; la 
posizione è rappresentata da un vettore che 
esprime le coordinate cartesiane del centro del- 
l'oggetto. 

Quindi andiamo a togliere dalla componente 
trasversale della porta la sua lunghezza; infine 
settiamo la nuova posizione della porta con un 
altra funzione di libreria, USetPos. La porta verrà 
spostata nella nuova posizione con un effetto 
"movimento" creato dal simulatore. Dopo aver 
imposto la nuova posizione, cambiamo nuova- 
mente stato, ponendo la porta nello stato "aper- 
to" (operi). 

Da notare che la componente da aggiungere 
dipende dall' orientamento iniziale della porta; 
ciò vuol dire che se orientiamo la porta lungo 
Tasse delle ascisse (x), la componente su cui 
operare sarà, appunto, la componente "x" (ed il 
codice verrà modificato in: pos.x = pos.x - 
2.000;). 

// La porta è aperta 
state open 



state_entry() 



state_entry() 



{ 



// Creiamo un timer di 2 secondi 



IISetTimerEvent(2.0); 



} 



// Evento scatenato dal timer 



timer() 



{ 



// Cancelliamo il timer 



IISetTimerEvent(O); 



// Cambiamo stato 



state closing; 



> 



} 



Lo stato open ci consente di analizzare un'altra 
funzione di libreria: llSetTimerEvent che ci con- 
sente di implementare la chiusura automatica 
della porta; la funzione viene utilizzata per sca- 
tenare un evento di tipo timer ogni qualvolta 
trascorre l'intervallo di tempo specificato come 
parametro della funzione. In questo caso, dopo 
due secondi viene invocato il metodo timer che, 
in primo luogo annulla il timer, passando alla 
funzione llSetTimerEvent il valore zero, quindi 
esegue una nuova transizione di stato che pone 
la porta "in chiusura" (closing). 

Il La porta si sta chiudendo 

state closing 

{ 



{ 



// Ricaviamo la posizione corrente della porta 

vector pos = IIGetPos(); 

// Aggiungiamo alla componente trasversale la 

lunghezza della porta 
pos.y = pos.y + 2.000; 
// Imponiamo la nuova posizione 
NSetPos(pos); 
// Cambiamo stato 
state default; 

_} 

} 



Nello stato closing non dobbiamo far altro che 
compiere il processo inverso rispetto al metodo 
opening. Impostiamo quindi la posizione della 
porta al valore iniziale e ci portiamo nuovamen- 
te nello stato di default. 



Ul\l SEMAFORO 

Per procedere nell'analisi del Linden Scripting 
Language, affrontiamo un esempio un po' più 
complesso. Finora abbiamo analizzato script 
associati ad un singolo elemento (prim); chiara- 
mente gli oggetti più complessi necessitano una 
composizione di più prim e, di conseguenza, la 
programmazione dell'oggetto composito neces- 
sita di ulteriori accorgimenti. Il primo oggetto 
composito che analizziamo è un semaforo che è 
composto da un supporto più le tre lampade dei 
colori. La composizione grafica del semaforo è 
semplice; basta creare tre cilindri (o semisfere se 
preferiamo) e porli sopra una base rappresenta- 
ta da un parallelepipedo. Per creare un unico 
oggetto è sufficiente selezionare ogni prim, 
quindi selezionare la voce "Link" dal menù 
"Tools". 

È importante definire opportunamente Lordine 
con cui selezioniamo i prim dato che LULTIMO 
selezionato prima dell'operazione di link sarà il 
root prim che regolerà il comportamento del- 
l'intero oggetto (Per avere più informazioni 
riguardo agli oggetti compositi possiamo far 
riferimento al wiki del LSL all'indirizzo 
http://lslwiki.net/lslwiki/wakka.php?wakka=link) . 
Vogliamo programmare il semaforo affinché 
riproduca il classico ciclo semaforico dei segna- 
li verde-giallo-rosso. In questo caso, vogliamo 
che i singoli prim interagiscano tra loro per sin- 
cronizzarsi a vicenda. In questo modo, il "rosso" 
comunica al "verde" quando accendersi; stessa 
cosa fa il "verde" nei confronti del "giallo" che, 
infine, a sua volta comunica con il "rosso". 
Esistono diverse modalità di comunicazione tra 
prim; in alcune situazioni si utilizza la funzione 






SCRIPT 
LIBRARY 

Una fonte molto ricca 
di esempi e relative 
spiegazioni di script in 
LSL è reperibile nel 
wiki all'indirizzo: 
http://lslwiki.net/lslwiki/w 
akka.php?wakka=ScriptLi 
brary 
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di libreria ÌÌSay (o ÌÌShout se vogliamo comuni- 
care a distanze superiori) che abbiamo già 
incontrato. Chiaramente dovremo specificare 
un canale diverso dallo usato per la chat. 
Normalmente questa modalità viene utilizzata 
per mettere in comunicazione prim "fisicamen- 
te" distanti come nel caso di un ascensore (che 
analizzeremo in un prossimo esempio). 
Nel caso in cui i prim sono "linkati" si preferisce 
utilizzare la funzione di libreria UMessageLinked 
che invia messaggi solo ai prim che compongo- 
no l'oggetto; ciò ci mette al riparo da eventuali 
"interferenze" che potrebbero sorgere a causa di 
altri oggetti che, accidentalmente, comunicano 
sul nostro stesso canale. 

Stabiliamo che l'accensione del semaforo viene 
scatenata dalla base che, in fase di avvio dell'og- 
getto, invia il primo messaggio ai prim (codice 
nel file Semaforo Baschi). 



default 


{ 


state_entry() 


{ 


// Inviamo il 


messagg 


o di ' 


'accensione rosso 
all'insieme 


di prim 


IIMessagel_inked(LINK_ 


_SET, 


0, 


"rosso", 


NULL_ 


KEY); 


} 


} 



La funzione di libreria UMessageLinked ha diver- 
si parametri; in questo caso il terzo parametro 
rappresenta il messaggio che viene inviato ovve- 
ro la lampada da accendere. Il primo parametro 
rappresenta il destinatario del messaggio; la 
parola chiave LINK_SET indica che il messaggio 
verrà recapitato a tutti i prim dell'insieme. 
Il codice presente nelle tre "lampade" è simile; 
nello stato predefinito ci mettiamo all'ascolto 
dei messaggi "linkati" per mezzo del metodo 
link_message. Ogniqualvolta arriva un messag- 




gio verifichiamo se è diretto al prim che stiamo 
codificando; in caso positivo attiviamo una 
transizione di stato, ovvero "accendiamo" la 
lampada. In caso negativo "spegniamo" la lam- 
pada. L'esempio di codice riguarda la lampada 
usata per il "rosso". 



default 


{ 


// Ascoltiamo i messaggi inviati all' 


insieme dei prim 


link_message(integer sender_num, 


integer num, 
string str, key id) 


{ 


// Se il messaggio è indirizzato all'oggetto 


if(str == "rosso") 


{ 


// Andiamo allo stato di accensione della lampada 


state accesa; 


} 


else 


{ 


// Spegnamo la lampada 


IISetAlpha(0.0, ALL_SIDES); 


} 


} 


} 



Per "accendere" e "spegnere" la lampada usia- 
mo la funzione di libreria USetAlpha che usiamo 
per definire la trasparenza/ opacità dell'oggetto. 
Quando dobbiamo spegnere la lampada impo- 
niamo il valore del primo parametro a 0. Il 
secondo parametro della funzione ci serve per 
definire su quali facce dell'oggetto dobbiamo 
imporre il valore di opacità; la parola chiave 
ALL_SIDES impone il valore in ogni faccia. 



// Stato di accensione della lampada 

state accesa 

{ 



state_entry() 



{ 



// Accendiamo la lampada 



IISetAlpha(1.0, ALL_SIDES); 



//Imponiamo la durata dell'accensione della 



lampada 



IISetTimerEvent(3); 



} 



timer() 



{ 



// Cancelliamo il timer 



IISetTimerEvent(O); 



// Informiamo l'insieme di prim che bisogna 

accendere il "verde" 
IIMessagel_inked(LINK_SET, 0, "verde", NULL_KEY); 



// Spegniamo la lampada 



IISetAlpha(0.0, ALL_SIDES); 



Figura 4: II semaforo in Second Life. 



Il Ci riposizioniamo nello stato predefinito 
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state default; 



} 



& 



} 



Nello stato accesa, come prima operazione 
accendiamo la lampada passando al metodo 
USetAlpha il valore 1 come primo parametro. 
Contestualmente attiviamo un timer 
(USetTimerEvent) che rappresenta la durata del- 
l'accensione della lampada. Trascorso il tempo 
prestabilito, tramite il metodo timer dobbiamo 
effettuare le seguenti operazioni: annullare il 
timer, inviare un messaggio ai prim relativo alla 
successiva lampada da accendere, spegnere la 
lampada attuale, riposizionarsi nello stato di 
default. 

Il codice per le diverse lampade è reperibile 
rispettivamente nei file Lampada Rosso.lsl, 
Lampada Verde.lsl e Lampada Giallo.lsL 
Nella Figura 4 è mostrato il nostro semaforo 



UN ASCENSORE 

Non tutti gli oggetti possono essere rappresen- 
tati in modo "compatto" linkando più prim. 
Nel caso di sistemi più complessi, le varie com- 
ponenti possono trovarsi distribuite nello spa- 
zio come nel caso di un ascensore che è forma- 
to dalla cabina e dai pulsanti ai piani da utiliz- 
zare per chiamare l'ascensore. 
Il codice associato ad ogni pulsante è molto 
semplice (fare riferimento ai file PulsanteO.lsl, 
Pulsante l.lsl, ecc.): 



default 


{ 


state_entry() 


{ 


// Creiamo un testo flottante al di sopra dell'oggetto 


IISetText("Chiamata",<0,0,0>,1.0); 


} 


touch_start(integer tota l_num ber) 


{ 


// "Gridiamo" sul canale 999 il messaggio "1" 


IIShout(999, "1"); 


} 


} 



Possiamo pensare di dare un aiuto agli avatar, 
mostrando un testo flottante in corrisponden- 
za del tasto tramite la funzione di libreria 
USetText. Quindi dobbiamo gestire la pressione 
del pulsante di chiamata codificando il metodo 
touch _start; in questo caso usiamo la funzione 
di libreria HShout in modo che anche in un edi- 
ficio "alto" le chiamate possano essere "ascol- 
tate" dalla cabina. Da notare che abbiamo scel- 



to il canale 999 per trasmettere i nostri messag- 
gi rappresentati semplicemente dal numero 
del piano a cui deve portarsi la cabina. 
Se passiamo ad analizzare il codice relativo alla 
cabina (file Cabina.lsl), dobbiamo gestire siala 
chiamata ad un piano, che il comando inviato 
dall'interno della cabina, dall' avatar che sale o 
scende. Presupponiamo che la cabina, indi- 
pendentemente dalla sua forma, possegga una 
seduta che consentirà all' avatar che si siede, di 
scegliere il piano a cui portarsi. Lo script che 
stiamo per analizzare dovrà essere posto all'in- 
terno della seduta che dovrà essere l'ultimo 
oggetto selezionato prima di linkare tutti i 
componenti della cabina ovvero il root prim 
dell'oggetto composito. 

Per rendere le cose più semplici definiamo due 
variabili globali: una lista che contiene le altez- 
ze dei vari piani (in modo da poter individuare 
immediatamente dove muovere la cabina) ed 
una ulteriore lista per contenere la lista dei 
piani. Le ulteriori variabili globali ci servono 
per definire la velocità con cui muoveremo la 
cabina, il piano e l'altezza attuale della cabina. 
Come annotazione, ricordiamoci che le varia- 
bili globali (che vediamo per la prima volta) 
vanno dichiarate in testa allo script e sono 
accessibili in ogni metodo di ogni stato all'in- 
terno dello script. 

Nel metodo state_entry dello stato predefinito 
{default), tramite la funzione di libreria 
UListen, ci poniamo in ascolto dei messaggi 
inviati sul canale 999 (quello dei pulsanti ai 
piani). Su questo canale dovremo trasmettere 
anche i comandi della pulsantiera della cabina 
(che implementeremo tra un attimo). La fun- 
zione di libreria USitTarget, predispone la 
seduta ad accogliere "opportunamente" l'ava- 
tar, accomodandolo esattamente sulla seduta e 
fronte verso l'esterno. L'ultima istruzione indi- 
ca all' avatar di sedersi. 



list ALTEZZE = [28, 29, 3C 


, 31]; 




list PIANI = ["0", "1", "2", 


"3"]; 




float SPEED = 0.1; 


integer piano; 


integer altezza; 


default 


{ 


state_entry() 


{ 


// Ci poniamo all'ascolto del canale 999 


IIListen(999, "", NULL_KEY, ""); 


// Facciamo in modo che l'avatar si segga 

corettamente 


IISitTarget(<0,-0.5,0.5>, 


IIEuler2Rot(<0,0, 


-90>) ); 


// Messaggioinformativo 


per l'avatar 




IISetText("Sedersi prego" 


,<0,0,0>,1.0); 
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> 



// Metodo che riceve i messaggi inviati dagli altri 

oggetti 
listen(integer channel, string name, key id, string 

message) 



{ 



// Verifichiamo che il messaggio proviene dal canale 

999 



if(channel == 999) 



{ 



// Impostiamo il piano a cui portare la cabina 



piano = (integer)message; 



// Cambiamo stato 



state moving; 



> 



> 



// Metodo scatenato dall'avatar che si siede in 



cabina 



changed(integer Change) 



{ 



// Mostriamo all'avatar la lista dei piani 
IIDialog(IIAvatarOnSitTarget(), "Scegliere il piano", 

PIANI, 999); 



> 



} 



mento della cabina che, tramite il metodo lis- 
ten appena visto, gestirà sia i messaggi prove- 
nienti dai piani che quelli provenienti dalla 
cabina. 

// La cabina si sta muovendo 

state moving 

{ 



state_entry() 



{ 



// Definiamo un timer che scatta ogni decimo di 

secondo 



IISetTimerEvent(O.l); 



// Ricaviamo l'altezza a cui portare la cabina 
altezza = IIList2Integer(ALTEZZE, piano); 



} 



// Metodo invocato ogni decimo di secondo 



timer() 



{ 



// Ricaviamo la posizione attuale della cabina 



vector pos = IIGetPosQ; 



// Se non siamo arrivati al piano ... 



if( pos.z!=altezza ) 



{ 



// Se la cabina è più in alto del piano a cui portarsi 



-e- 



Nello stato predefinito della cabina, dobbiamo 
altresì codificare il metodo di "ascolto" dei 
messaggi (listerì) ed il metodo scatenato dall'a- 
vatar che si siede in cabina (changed). Nel 
primo metodo, dopo aver verificato che il mes- 
saggio provenga dal canale 999, valorizziamo 
la variabile globale piano con il valore del mes- 
saggio che contiene, appunto, il piano a cui è 
stata chiamata la cabina; quindi ci posizionia- 
mo sullo stato moving. 

Nel metodo changed, che si "accorge" che un 
avatar si è seduto in cabina, facciamo la cono- 
scenza di una funzione di libreria che ci con- 
sente di interagire con gli avatar. La funzione 
di libreria UDialog mostra un dialogo ad un 
avatar, dove sono presenti diversi pulsanti che 
possono essere usati per consentire una scelta. 
La funzione accetta quattro parametri: la key 
dell' avatar a cui mostrare il dialogo, un mes- 
saggio esplicativo, una lista di opzioni (che ver- 
ranno trasformate in pulsanti) ed un canale su 
cui trasmettere la scelta effettuata. Affinché il 
dialogo sia mostrato effettivamente all'avatar 
che si siede in cabina, usiamo la funzione di 
libreria HAvatarOnSitTarget che restituisce la 
key dell' 'avatar che è attualmente seduto sul- 
l'oggetto. 

È appena il caso di notare come il canale che 
utilizziamo per trasmettere la scelta dell' avatar 
è proprio il 999 dove vengono trasmessi anche 
i comandi dei pulsanti a piani. In questo modo 
abbiamo centralizzato la gestione del movi- 



if( pos.z>altezza ) 



{ 



// Facciamo scendere la cabina 



pos.z = pos.z - SPEED; 



> 



else 



{ 



// Facciamo salire la cabina 



pos.z = pos.z + SPEED; 



> 



} 



// Se siamo in un "intorno" del piano inferiore allo 

step di movimento ... 
if( IIFabs(pos.z - altezza) < SPEED ) 

_C 

// Definiamo precisamente la posizione della cabina 

pos.z = altezza; 

// Azzeriamo il timer 

IISetTimerEvent(O); 

// Applichiamo la posizione alla cabina 

NSetPos(pos); 

// Informiamo l'avatar che siamo arrivati 
IISay(0, "Ascensore al piano" ); 
// Ci posizioniamo nello stato predefinito 
state default; 

_} 

// Applichiamo la posizione alla cabina 

NSetPos(pos); 

} 



Per implementare il movimento della cabina, nel 
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metodo statejentry dello stato moving, definiamo 
un timer che scatta ogni decimo di secondo. Nel 
corrispondente metodo timer, facciamo una sem- 
plice operazione di confronto tra l'altezza attuale 
della cabina (tramite la componente Z della sua 
posizione attuale) e l'altezza a cui dobbiamo porta- 
re la cabina. La differenza tra queste due grandezze 
ci consente di aggiungere o togliere uno "step" di 
movimento (definito tramite la variabile globale 
SPEED). Dato che questa operazione viene esegui- 
ta ripetutamente ciò che ne ricaviamo è un movi- 
mento "abbastanza" fluido della cabina. Quando 
siamo in corrispondenza del piano, ovvero quando 
la differenza tra la posizione attuale della cabina e 
l'altezza a cui dobbiamo portarla è minore, in valo- 
re assoluto, allo "step" di movimento, vuol dire che 
siamo arrivati. In questa situazione azzeriamo il 
timer ed informiamo l'avatar che siamo arrivati. 
L'implementazione del movimento appena vista ci 
potrebbe far sorgere una domanda: ma perché non 
abbiamo imposto semplicemente la posizione 
della cabina con il valore dell'altezza a cui dobbia- 
mo portarla? Avremo risolto il problema con una 
sola linea di codice ma l'effetto collaterale è che l'a- 
nimazione che il simulatore produce a fronte di 
una semplice variazione di posizione è estrema- 
mente rapida. Questo vuol dire che ogni volta 
saremmo "sparati" al piano piuttosto che "portati". 
Per questa ragione abbiamo dovuto parcellizzare il 
movimento, scomponendolo in tanti "piccoli" 
movimenti. Per provare i nostri script non dobbia- 
mo necessariamente associarli agli oggetti che "in 
produzione" verranno animati da ciò che produ- 
ciamo. Nel caso dell'ascensore, per esempio, non 
dobbiamo, per fora, creare un palazzo, una serie di 
piani, una cabina più o meno verosimile, ecc. Per 
provare il nostro lavoro ci è sufficiente lavorare con 
i "cubi" che chiunque di noi è in grado di costruire. 
Ad ogni cubo possiamo associare il relativo script e 
quindi fare le prove del caso. Nella figura 5 è pre- 
sente un esempio eclatante del ragionamento 
appena fatto, dove l'ascensore ed i pulsanti di chia- 
mata sono tutti rappresentati, appunto, da cubi. Il 
risultato grafico è tutt' altro che esaltante ma riu- 
sciamo a testare in tutto e per tutto le funzionalità 
che intendevamo realizzare. Questo ci consente di 
essere sicuri del risultato quando andremo a porre 
gli script negli oggetti gentilmente creati dai nostri 
grafici. 



UNA PORTA 
"A CARDINI" 

Facciamo un passo indietro e torniamo ad ana- 
lizzare una porta; questa volta però producia- 
mo una classica porta che ruota attorno ai sui 
suoi cardini. Per sviluppare questo nuovo 



esempio, studieremo come far ruotare i corpi 
in SL. Anche in questo caso useremo un ogget- 
to composito formato dall' anta della porta e 
dai suoi cardini. Possiamo rappresentare que- 
sti ultimi come un minuscolo parallelepipedo 
che accostiamo ad uno dei lati dell'anta. 
Premesso che l'oggetto composito ha come 
root prim, i cardini, porremo proprio in questo 
oggetto il codice contenuto nel file Porta 
Cardini. Isl. Nello stato predefinito (default) 
consideriamo la porta chiusa. Per aprire la 
porta basta toccare la sua anta che scatena l'e- 
vento touch_start. Come prima operazione 
memorizziamo la rotazione attuale della porta 
nella variabile globale rot, quindi eseguiamo 
una transizione di stato che posiziona l'ogget- 
to nello stato opening. 

Il Variabile globale per memorizzare la rotazione 

attuale della porta 
rotation rot; 

// Variabile globale per memorizzare la rotazione per 
aprire/chiudere la porta 
rotation delta; 



default 



{ 



// Evento scatenato dal tocco dell'avatar 



touch_start(integer total_number) 



{ 



// Memorizziamo la rotazione attuale della porta 



rot = IIGetLocalRotQ; 



// Cambiamo stato 



state opening; 



> 



} 



Nello stato opening definiamo la rotazione che 
deve compiere la porta quando si apre. In que- 
sto caso, usiamo la funzione di libreria 
HEuler2Rot che trasforma una rotazione 
espressa tramite un vettore in cui indichiamo 





Figura 5: Uno "strano", ma funzionale, ascensore. 



http://www.ioprogrammo.it 



Ottobre 2007/ 21 + 



014-022:066-071 31-08-2007 15:44 Pagina 22 



COVER STORY T ■ Introduzione a Linden 




-0- 




Oscar Peli (alias 

DaveGahan 

Homewood in Second 

Life) è .NET Solution 

Architect ed 

amministratore dei 

dispositivi mobili 

presso il Comune di 

Ancona. 

Come consulente ha 

sviluppato presso 

l'Università degli Studi 

di Macerata un 

sistema di 

pubblicazione di 

contenuti per il 

supporto a progetti di 

ricerca 

(http://reti.unimc.it). 

Oscar è contattabile 

all'indirizzo: 

opeli@unimc.it. 



gli angoli di rotazione attorno agli assi, in una 
variabile di tipo rotation che esprime la rota- 
zione tramite una quaterna di valori (una trat- 
tazione dettagliata relativa alla gestione delle 
rotazioni con il LSL è reperibile all'indirizzo 
http://lslwi ki.net/lslwi ki/wakka.ph p?wakka=rota - 
tion ). 

Per definire una rotazione longitudinale (ovve- 
ro attorno all'asse Z) di 90 gradi, passiamo alla 
funzione un vettore con le prime due compo- 
nenti a zero e con la terza componente valoriz- 
zata con la parola chiave PI/2. L' effettiva rota- 
zione si calcola moltiplicando il valore ottenu- 
to dalla funzione, per la rotazione attuale. 
Tramite la funzione di libreria USetRot, appli- 
chiamo la rotazione che viene eseguita, come 
le transizioni longitudinali, in modo fluido dal 
simulatore. 



// La porta si sta aprendo 



state opening 



state_entry() 



{ 



// Definiamo una rotazione di 90 gradi attorno 

all'asse Z 

delta = IIEuler2Rot(<0.0,0.0,PI/2>); 

// Calcoliamo la rotazione sulla base della rotazione 

attuale 
rot = delta * rot; 



// Applichiamo la rotazione 



IISetRot(rot); 



// Cambiamo stato 



state open; 



> 



> 



Dato che anche in questo caso vogliamo dota- 
re la porta di chiusura automatica, nello stato 
open impostiamo un timer che rappresenta il 
tempo in cui la porta resta aperta. Trascorso il 
periodo di tempo che abbiamo impostato, ci 
posizioniamo nello stato dose che compie la 
rotazione inversa e riposiziona la porta nel suo 
stato predefinito {default). 



Il La porta è aperta 



state open 



state_entry() 



{ 



// Creiamo un timer di 2 secondi 



IISetTimerEvent(2.0); 



// Evento scatenato dal timer 



timer() 



{ 



IISetTimerEvent(O); 



// Cambiamo stato 



state closing; 



} 



} 



// La porta si sta chiudendo 



state closing 



{ 



state_entry() 



{ 



// Definiamo una rotazione di meno 90 gradi 



attorno all'asse Z 



delta = IIEuler2Rot(<0.0,0.0,-PI/2>); 

// Calcoliamo la rotazione sulla base della rotazione 

attuale 
rot = delta * rot; 



// Applichiamo la rotazione 



IISetRot(rot); 



// Ci riposizioniamo nello stato predeinito 



state default; 



} 



// Cancelliamo il timer 



> 



Come ultima indicazione è bene sottolineare 
che, come in ogni altro linguaggio di program- 
mazione, anche con il LSL è possibile imple- 
mentare una stessa soluzione utilizzando tec- 
niche diverse. Nel caso della porta ruotante, un 
ulteriore esempio è reperibile nel wiki dedica- 
to al linguaggio ( http://lslwiki.net/lslwiki/wakka. 
php?wakka=LibraryDoor ); in particolare, l'esem- 
pio propone una porta formata da un unico 
prim, configurata in modo da assumere un 
aspetto molto "verosimile", e con tanto di 
effetti sonori di apertura e chiusura. 



CONCLUSIONI 

Un nuovo mondo, una seconda vita. Questa è 
la prospettiva che ci attende se decidiamo di 
connetterci a Second Life: " Un mondo virtuale 
3-D interamente costruito e posseduto dai suoi 
residenti". "Costruire", in Second Life, non 
significa "solo" produrre fantastiche opere in 
grafica 3-D; per rendere "vivi" gli oggetti di SL, 
è necessario produrre degli script con il lin- 
guaggio di programmazione Linden Scripting 
Language. Nell'articolo che abbiamo appena 
letto abbiamo iniziato ad esaminare le basi del 
linguaggio, utilizzando un approccio di tipo 
"hands-on-lab" in cui abbiamo potuto esami- 
nare, attraverso degli esempi "reali", alcune 
delle funzioni di libreria, che ci hanno consen- 
tito di spostare, ruotare, sincronizzare gli 
oggetti del nuovo "mondo". 

Oscar Peli 
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CREA IL TUO ROBOT 
A COLPI DI CLICK 

MICROSOFT HA APPENA PRESENTATO IL SUO "VISUAL STUDIO ROBOTICS", IL PRIMO 
AMBIENTE RAD E VISUALE PER LO SVILUPPO RAPIDO DI APPLICAZIONI DESTINATE 
ALL'AUTOMAZIONE ROBOTICA. ECCO COME INSTALLARLO E USARLO FACILMENTE 
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Tempo di realizzazione 



Tutto nasce da un articolo di Bill Gates sul- 
l'autorevole rivista americana Science inti- 
tolato "A robot in every home" . . . 
Il Chief Architect di Microsoft racconta che, negli ul- 
timi anni, in occasione di visite alle principali Uni- 
versità americane, tra i progetti che gli venivano 
presentati, ve ne era costantemente almeno uno 
dedicato all'automazione ed alla robotica. . . 
Bill Gates ha riflettuto su tutto questo e con un au- 
dace volo di fantasia ha ritrovato delle somiglian- 
ze tra l'attuale scenario della cibernetica e quello del- 
l'informatica, all'epoca in cui lui e Steve Alien muo- 
vevano i primi passi. . . 

Per essere protagonista anche di questa rivoluzio- 
ne prossima ventura ha promosso il rilascio una 
serie di software adeguati alla programmazione 
dei Robot; 

Visual Robotics Studio è appunto l'ambiente di 
programmazione che Microsoft dedica alla ciber- 
netica; 

Il colosso di Redmond ha seguito una filosofia di 
sviluppo analoga a quella già implementata con 
l'XBox, assemblando in maniera originale tecnologie 
che Microsoft conosce bene; 
il risultato è una specie di Visual Basic che al po- 
sto della tipica toolbox riunisce, come in una ca- 
tena di montaggio, pezzi di robot mettendo in gio- 
co anche i web services, uno dei cavalli di batta- 
glia della prima release di .net, e XNA il Kit di svi- 
luppo dedicato ai videogiochi della XBox 360°, etc 
Vediamo nel dettaglio come lavora questo Ali Star 
Team 



VISUAL PROGRAMMINO 
LANGUAGE 

Il primo Tool che prendiamo in esame si chiama 
Visual Programming Language; 
attraverso una interfaccia grafica, che funziona co- 
me una lavagna, disegniamo una sorta di catena 
di montaggio che collega e fa funzionare i diversi com- 
ponenti di una automazione; 
L'ambiente grafico è raffigurato in Fig 1: 
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Figura 1: L'ambiente di programmazione di Visual 
Studio Robotics 



SERVICES 

Evidenziata in rosso troviamo la finestra Services; 
è un elenco di 'pezzi di Robot': 
scorrendoli scopriamo oggetti come i mattoncini 
LEGO MindStorm e Fishertechnics, joystick per vi- 
deogiochi, ma anche hardware semi professiona- 
le come il MobileRobot Pioneer fabbricato da Mo- 
bileRobots od i componentistica della Parallax; 
questi 'pezzi di Robot', o per essere tecnici 'Services', 
rappresentano l'hardware ai quali fanno riferi- 
mento, ne avvolgono la complessità e la astraggo- 
no, rendendola trasparente allo sviluppatore; 
per iniziare a lavorare con i Services non abbiamo 
che da clickarvi sopra e trascinarli nella finestra 
centrale Diagram, evidenziata in blu; 
è inevitabile notare le somiglianze con i tipici am- 
bienti di sviluppo di Microsoft: 
clickare sopra un servizio e trascinarlo nella fine- 
stra Diagrams è una procedura analoga alla crea- 
zione di pulsanti, Textbox, eccetera, nelle WebForm 
e WindowsForm, ovvero un paradigma di pro- 
grammazione presente sin dalla primissima re- 
lease di Visual Basic! 
Non solo... 

Le specifiche dei "Pezzi di Robot" sono descritte 
in file Manifest, ovvero in file di configurazione in 
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formato XML; 

i file Manifest sono forniti principalmente dai fab- 
bricanti di Robot e, con l'andare del tempo, Mi- 
crosoft conta di coprire ogni tipo di Hardware di- 
sponibile; I Services, con i relativi file Manifest, for- 
niti dai fabbricanti di hardware ci ricordano senza 
dubbio i vari componenti sviluppati da terze par- 
ti disponibili per Visual Studio. 



di automazione descritto in un diagramma i una 
Activity'; F Activity viene compilata selezionan- 
do la voce Run dai menù a tendina (cfr. Fig. 2 e di- 
dascalia) 
• Comment Inserisce un commento esplicativo 
al flusso di automazione; non influenza il pro- 
gramma ma lo chiarisce ai nostri occhi 

Per finire, a sinistra del tool VPL troviamo le finestre 
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BASIC ACTIVITIES 

Una volta disposti i 'pezzi di robot', o per usare il 
termine tecnico i Services, è necessario fornirgli 
delle istruzioni e farli dialogare tra loro; 
le istruzioni vengono allocate e manipolate attra- 
verso una serie di oggetti denominati "Basic Acti- 
vities" disponibili nella finestra evidenziata in ver- 
de. Le Basic Activities sono rappresentate grafica- 
mente attraverso 'quadratini' con segmenti verdi sui 
lati sinistro e destro; il nome in codice di questi 
segmenti verdi è 'pin activities'; nel diagramma 
della nostra automazione i dati che 'rendono elet- 
trici' i vari Services entrano nel pin posto a sini- 
stra del 'quadratino' ed escono, dopo essere stati 
elaborati ed instradati, dal pin posto a destra; 
ogni finestra "Basic Activities" possiede Wizard di 
configurazione per impostare semplicemente le 
sue proprietà; Vediamo le varie 'Basic Activities' 
nel dettaglio 

• Variabile Crea una variabile e la tipizza; le va- 
riabili sono tipizzate attraverso i medesimi tipi pre- 
visti in C# (cfr. Box dedicato) 

• Data Alloca i dati della nostra automazione in 
variabili (ad esempio inserisce "Hello World" in 
una variabile di tipo String ) 

• List Crea e tipizza una serie di dati (nota che è 
possibile creare una lista di dati anche con 'Va- 
riable') 

• List Functions Consente di modificare un List 
pre esistente 

• Calcolate Consente di sommare, sottrarre divi- 
dere o moltiplicare variabili numeriche oppure 
di concatenare stringhe 

• If Questa Activity in maniera analoga ad un tipico 
ciclo condizionale If/ Else, sposta il flusso del- 
l'automazione verificando se una condizione è 
vera oppure è falsa 

• Switch In maniera analoga aU'Activity sposta il flus- 
so dell'automazione ma a differenza di questo 
smista il flusso confrontando il messaggio in in- 
gresso con un valore impostato dallo sviluppatore 

• Merge 'Fonde' semplicemente tra loro due o più 
flussi di automazione 

• Join Unisce due o più flussi di automazione dan- 
do ad ognuno di questi uno specifico nome 

• Activity È possibile racchiudere l'intero flusso 



Project 

che, in maniera analoga alla finestra Project di Vi- 
sual Studio, ci consente di impostare il nome del 
Diagramma, di aggiungere oppure o cancellare un 
diagramma 

Properties 

che consente, in maniera analoga alla finestra Pro- 
perties di Visual Studio, di impostare le proprietà del- 
l'oggetto Services oppure Activity selezionato. 



IL PROGETTO D'ESEMPIO 



Questo è il diagramma, basato su 
quelli allegati all'articolo che 
implementa l'automazione di un 
robot comandato da un Joystick; 
sono messe in gioco tutte le Basic 
Activities di cui abbiamo parlato e 
diversi Services i cui file Manifest 
supportano il Simulatore; In breve 
l'automazione funziona in questo 
modo: durante la simulazione, se 
premi il bottone Stop, le ruote 
non ricevono dati e si fermano se 
spingi la leva avanti le ruote sono 
spinte in avanti grazie a dati di 
valore positivose spingi la leva 
indietro le ruote sono spinte 
indietro grazie a dati di valore 



negativo Le ruote sono fissate ad 
un asse e ruotano a sinistra ed a 
destra se una è spinta verso un 
valore positivo e l'altra è spinta 
verso un valore negativo equiva- 
lente o viceversa. 
Nota il Services di tipo Activity 
che incapsula tutto il flusso di 
Automazione del nostro 
Diagramma ed i vari commenti 
esplicativi. Il disegno, o per usare 
il termine tecnico, il diagramma 
che creiamo ricorda concettual- 
mente un diagramma UML oppu- 
re anche ad tipico diagramma di 
flusso ma non coincide affatto 
con questi formalismi 
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Visual Studio Programming viene fornito con una 
serie di diagrammi esemplificativi; 
ho preso il quarto di questi esempi e l'ho modificato 
per renderlo più calzante ai nostri scopi "didatti- 
ci". 



comunicano e richiedono la connessione con un Ro- 
bot vero e proprio (cfr. Fig. 3 e relativa didascalia); 
Nel nostro caso, poiché non disponiamo di alcun Ro- 
bot, è necessario lanciare il simulatore grafico, nome 
in codice Microsoft Visual Simulation Environment 



ROBOT & 
REALTA VIRTUALE 

Questo paragrafo risponde alla domanda: "Come 
i diagrammi di VPL riescono a diventare un'auto- 
mazione?" 

Una volta assemblata l'automazione, clickando 
sull'icona Play, anch'essa tipica degli ambienti di svi- 
luppo Microsoft, è possibile telecomandare un ro- 
bot, oppure avviare una animazione che simula 
l'automazione, quasi fosse un videogioco. 
Sono i files Manifest dei diversi Services che im- 
postano il simulatore grafico piuttosto che l'hardwa- 
re; per intendersi, il simulatore viene avviato quan- 
do l'automazione utilizza Services le cui caratte- 
ristiche sono descritte in file Manifest che richiedono 
il simulatore grafico mentre automazioni assemblate 
con Services i cui Manifest richiedono hardware 
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L'AMBIENTE DI SIMULAZIONE 



Dalla Finestra Diagram del VPL è 
possibile selezionare quale File 
Manifest intendiamo utilizzare per 
i nostri Services: Se utilizziamo un 
File Manifest dedicato ad 
Hardware reale il Framework cer- 
cherà i pezzi restituendo un mes- 
saggio di errore se non li trova 
(non ho il mattoncino Lego 
Mindstorm e non viene intercetta- 
ta alcuna connessione Bluetooth) 
Se utilizziamo invece un Manifest 



dedicato ad una Hardware simula- 
to viene lanciato automaticamen- 
te il Visual Simulation 
Environment ( un robot Lego 
Mindostorm inizia la sua esplora- 
zione nel mondo virtuale realizza- 
to con il game engine di AGEIA e 
XNA ); Nota bene che se avessimo 
il file Manifest relativo potremmo 
pilotare, dal nostro computer, i 
robot Spirit ed Opportunity che 
hanno esplorato Marte 










MICROSOFT VISUAL 

SIMULATION 

ENVIRONMENT 

Se, testando le vostre applicazioni con il simula- 
tore, avete l'impressione di giocare con un video - 
games non siete poi così lontani dalla realtà. . . 
La tecnologia impiegata per il Visual Simulation 
Environment è appunto quella del Game Engine 
PhisX della software House Ageia. 
ricordo brevemente che un Game Engine è un 
software "a basso livello", utilizzato nella pro- 
grammazione dei videogiochi, che si occupa della 
grafica, delle leggi fisiche, delle animazioni e del- 
l'intelligenza artificiale, etc fornendo un modello 
coerente sul quale lo sviluppatore può lavorare. 
Questo Game Engine è programmato utilizzando 
un ambiente di sviluppo che dovrebbe essere no- 
to ai lettori di IoProgrammo: XNA Game Studio di 
Microsoft, che viene utilizzato principalmente nel- 
la programmazione della console XBOX 360°. . . 
Lo spazio di un articolo è sempre troppo breve e 
non mi è possibile sviscerare tutte le funzionalità 
del simulatore che sono comunque piuttosto in- 
tuitive; 

vale la pena però spiegare brevemente come è pos- 
sibile personalizzare lo scenario delle nostre si- 
mulazioni.. 

È possibile aggiungere, posizionare o eliminare le 
figure geometriche che popolano lo scenario del- 
la simulazione entrando nella modalità Edit attra- 
verso la pressione del tasto funzione F5; 



j*_» non 



Figura 4: Nota bene che è possibile creare nuove entità 
per popolare lo scenario importandole da un ambiente di 
modellazione grafica evoluto quale 3d studio max! 



confrontando la Fig. 4 scopriamo che a sinistra del- 
la tipica finestra del simulatore si va ad aggiunge- 
re un'area che 
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• Enumera tutti gli elementi che popolano la si- 
mulazione (evidenziata in rosso) 

• Consente di posizionare un elemento selezio- 
nato secondo i tre piani cartesiani ed anche di 
ruotarlo (evidenziata in blu) 

È possibile modificare gli elementi geometrici del- 
la simulazione seguendo questa procedura: 

a. Selezionandoli nell'area evidenziata in rosso 

b. Dopo, attraverso il menù a tendina Entity, con le 
tipiche operazioni di Copia & Incolla è possibi- 
le cancellarli, raddoppiarli oppure eliminarli. 

Dal menù a tendina File è possibile salvare uno 
scenario (selezionando Open Scene. . .) e caricarne 
uno (selezionando Save Scene as...); 
negli esempi allegati all'articolo troverete anche 
uno scenario dedicato all'automazione di esem- 
pio che vi consentirà di guidare il robot fatto con i 
Lego in un percorso a zig a zag attraverso una se- 
quenza di coni stradali. 

Nota, per concludere, che è anche possibile mo- 
dificare la gravità del nostro scenario, un'opzione 
che si può rivelare utile qualora dovessimo pro- 
gettare l'automazione per un robot esploratore su 
Marte o sulla Luna. 



PROGRAMMAZIONE 
DEI SERVICES 

Discutendo con l'Ing. Manfrin sul Kit di sviluppo l'at- 
tenzione è stato soprattutto focalizzata sul con- 
cetto di Orchestration: 

con "Orchestration" intendiamo la perfetta sin- 
cronia, dall'inizio alla fine, di tutti i Services che 
compongono la nostra automazione; 
per intendersi: nella nostra simulazione non suc- 
cede nulla se il nostro robot, fatto con i Lego vir- 
tuali, urta un ostacolo per una disattenzione, men- 
tre nella realtà gli errori casuali o le imprecisioni 
di una macchina utensile possono causare danni 
incalcolabili, pensate alla catena di montaggio di 
una fabbrica di automobili i cui robots, scoordi- 
nati, smaltano, saldano, assemblano pezzi che non 
sono ancora arrivati o sono sistemati male. 
L' Orchestration è un problema assimilabile ai pro- 
blemi classici di sincronizzazione dei Threads nei 
Sistemi operativi, esemplificati con celebri rom- 
picapo quali la "Torre di Hanoi" piuttosto che la 
"Cena dei Filosofi; 

problemi molto complessi, infernali che sono par- 
te degli incubi degli informatici quasi da sempre. . . 
Programmare un'applicazione con Microsoft Ro- 
botics significa dunque gestire la difficile Orche- 
stration tra gli input e gli output che si scambiano 
i Services; 

L' Orchestration viene gestita da una nuova libre- 
ria software che è probabilmente la punta di diamante 



del Pool di software che compongono questo ori- 
ginalissimo Framework: 

Concurrency and Coordination Runtime (CCR) 
che tenta di risolverla rendendola invisibile ai no- 
stri occhi, ovvero gestendola dietro le quinte. 
Nota che Bill Gates nel sopraccitato articolo sulla 
rivista Science nomina esplicitamente il CCR, ad 
un pubblico non specializzato, spiegando appun- 
to che risolve (sic. . .) il problema del MultiTasking 
di diversi processi paralleli 



IL CCR VISTO DA VICINO 

Prima di addentrarci nei dettagli di questo com- 
ponente software è necessario capire bene che co- 
sa fa: immaginate di dovere creare una intranet per 
una LAN composta da 100 computer e dover veri- 
ficare se tutti sono online: probabilmente scrivereste 
un componente che lancia un ping verso ogni sin- 
golo computer e ne attendi la risposta, gestendo- 
la poi per i vostri scopi. 

Utilizzando la libreria CCR non avreste che da dir- 
gli che cosa fare (lanciare un ping ) e come gestire 
le risposte; ogni singolo ping viene gestito dal CCR 
creando per ogni IP un thread che utilizzerà la sche- 
da di rete in più richieste parallele. 
Enunciato in questi termini la libreria pare essere 
proprio essere una cosa notevole, 
la realtà però non è così rosea.. Il CCR, visto da vi- 
cino ha un aspetto piuttosto ostile.. 
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Figura 5: Lo schema della CCR 



La libreria CCR (cfr. Fig. 5) è scritta in C# e sfrutta 
alcune caratteristiche della nuova release del Fra- 
mework.net; 



LA CLASSE PORT 

Il CCR innanzitutto definisce una classe di tipo 
Port che riceve in ingresso i parametri che do- 
vranno essere elaborati tipizzandoli; 
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Ad esempio questo pezzo di codice 

Port<float> pF = new Port<float>() ; 
significa che abbiamo istanziato una classe Port 
di nome pF che riceve in ingresso un parametro di 
tipo Float (nota le parentesi angolari); 
è possibile ingressare 16 parametri di tipo diver- 
so; 
con questa sintassi, ad esempio 

PortSet<int,string> pIS = new PortSet<int,string>(); 

passiamo due parametri di tipo integer e string. 
La classe di tipo Port comprende una struttura di 
dati FIFO ( il dato che entra per primo (First In) è 
il primo dato che viene elaborato e restituito (Fir- 
st Out) ); i dati accodati nella porta vengono poi "af- 
fidati" ad un arbitro che a sua volta chiama, 
facendo uso di delegate e metodi anonimi, una 
funzione da eseguire su questi dati; per la preci- 
sione i dati sono elaborati chiamando un delega- 
te (un costrutto tipico di .net, simile alle chiama- 
te a funzioni del C), che viene associato ad un me- 
todo denominato oppure, ed è questa la novità, 
un metodo anonimo; i metodi anonimi sono una 
novità di C# e, in maniera elegante consentono 
di passare un blocco di codice come parametro 
del delegate. Ad esempio: 

// Crea un gestore per un evento Click 
buttonl. Click += delegate(System.Object o, 

System. EventArgs e) 

{ 
System. Windows. Forms.MessageBox.Show("Click!"); 

}; 

I metodi supportati dalla classe Port sono 
Post che invia un messaggio ad una porta 



funzione specifica, e poi li invia alla classe Di- 
spatcherqueue che li smista. Brevemente i meto- 
di della classe Arbiter, ordinati dai più semplici 
verso i più complessi 

public static class Arbiter { 

public static ITask FromHandler(Handler 
handler); 

è un metodo che specifica che un valore può es- 
sere accodato verso una classe DispatcherQueue 
(che vedremo più avanti). 

Questo semplice membro della classe Arbiter non 
è associato ad alcun membro della classe Port 

public static ITask FromIteratorHandler(Handler 

handler); 

è un metodo che enumera diversi valori che pos- 
sono essere accodati verso una classe Dispat- 
cherQueue che vedremo più avanti. 
Non è associato ad alcun membro della classe 
Port 

public static Receiver<T> Receive<T>( 

Boolean persist, Port<T> port, Handler<T> 

handler); 

è un metodo che può essere chiamato per passa- 
re il risultato di una elaborazione verso una singola 
porta. Deve essere specificato sia il delegate che chia- 
merà l'evento sia la porta. 

public static JoinSinglePortReceiver 

MultipleItemReceive<T>( 
Boolean persist, Port<T> port, Int32 

itemCount, 
VariableArgumentHandler<T> handler); 



Port<int> pi = new Port<int>() 



pi. Post (42) ; 

Test che verifica, attraverso un valore Booleano 
di ritorno, se la porta è occupata 



è un metodo che può essere chiamato per invia- 
re diversi risultati dell'elaborazione verso una sin- 
gola porta. 

Il parametro inviato al delegate VariableArgu- 
mentHandler consiste in un array di oggetti Port 



int iv ; 


if (pi. Test (out iv)) 


Console. WriteLine 


("Read " + iv) ; 


else 


Console. WriteLine 


("Port empty.") ; 



LA CLASSE ARBITER 

Una volta che i messaggi sono passati attraverso 
la classe Port e necessario elaborarli e smistarli; 
questo compito è svolto dalla classe Arbiter che 
li elabora utilizzando un delegate, che chiama la 



public static JoinReceiver MultiplePortReceive<T>( 
Boolean persist, Port<T>[] ports, 
VariableArgumentHandler<T> handler); 

è un metodo che può essere chiamato per invia- 
re un singolo risultato dell'elaborazione verso 
molteplici porte. Gli item devono essere del me- 
desimo tipo delle porte. Il parametro inviato al 
delegate VariableArgumentHandler consiste in 
un array di oggetti Port 



... // ed altri membri omessi per brevità 


} 
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LA CLASSE 
DISPATCHERQUEUE 

il termine queue significa coda ed identifica la co- 
da delle richieste dell'elaborazione che la classe 
Arbiter desidera siano smistati dalla classe Di- 
spatcher; 

I threads gestiti nella classe del Dispatcher sono 
in attesa degli input accodati nella classe Dispat- 
cherQueue 



public sealed class DispatcherQueue : ID 


isposable { 


/* Usa il pool di thread gestito dal CLR non quello 

del Dispatcher più 


flessibile */ 


public DispatcherQueue(string name); 


public DispatcherQueue(String name, 


Dispatcher 
dispatcher); 


public void Dispose(); 


... // altri membri omessi per brevità 


} 



LA CLASSE DISPATCHER 

Il compito di sincronizzare i vari thread dell'ela- 
borazione viene affidato alla classe Dispatcher. 
La classe Arbiter ha accodato alla dispatcherqueue 
delle funzioni da eseguire. La classe Dispatcher 
trova nella queue che funzioni ci sono e le esegue 
attraverso il Multithreading, cioè in parallelo. 

public sealed class Dispatcher : IDisposable { 
public Dispatcher(); 
public Dispatcher(Int32 threadCount, String 

threadPoolName); 
public Dispatcher(Int32 threadCount, 

Thread Priority priority, 
String threadPoolName); 
public ICollection<DispatcherQueue> 

DispatcherQueues { get; } 



// altri membri omessi per brevità 



} 



Per default ogni thread viene indirizzato ad ogni 
singola CPU presente nel computer ( nota che in 
questo modo sono ottimizzati i moderni proces- 
sori Multi Core) ed esternamente è possibile iden- 
tificare ogni singolo thread attraverso una strin- 
ga e settarne il livello di priorità (per default, il 
Framework assegna ad ogni thread un nome che 
viene poi utilizzato nel Visual Studio® debugger's 
Threads). È possibile creare molteplici classi Di- 
spatcher, ognuno con il suo pool di threads am- 
plificando indefinitamente le possibilità di ela- 
borazione dello stesso. Per concludere avrete cer- 
tamente compreso che II CCR è un componete 
ostico da programmare e probabilmente vi sare- 
te resi conto che gestire l'orchestrazione tra i va- 



ri Services sarebbe ben più difficile che non co- 
struire a mano il proprio Robot. . . Ebbene le buo- 
ne notizie sono che grazie a Microsoft Robotica 
Studio, non avrete da scrivere una sola riga di co- 
dice; l'intera implementazione del CCR viene ge- 
stita attraverso il VPL che genera tutto il codice del 
quale abbiamo bisogno senza doverci mettere le 
mani; La documentazione del CCR per ora è vera- 
mente scarsa ma le potenzialità di questo compo- 
nente sono tali che, dovrebbe entrare a fare parte 
integrante delle prossime release di .net 



CONCLUSIONI 

Microsoft, ogni volta che si trova ad affrontare una 
sfida in un settore tecnologico differente dal suo 
'Core Business', non parte dal nulla ma riprende, 
rielaborandoli, diversi suoi cavalli di battaglia; la 
cosa è evidente in XBox è soprattutto in questo 
Robotic Development Kit che ci presenta sotto una 
luce nuova non poche vecchie conoscenze. . . Tra 
queste la vera novità e la libreria CCR che molti 
sviluppatori vorrebbero ripreso nella Release 
ufficiale del .NET Framework; Abbiamo parlato di 
robots e posto l'accento sulle comunità di 
appassionati che li smanettano ma il VRS non è un 
curioso Gadget quanto piuttosto lo strumento che 
programma le macchine utensili e le catene di 
montaggio; è appena uscito dalle officine Microsoft 
ed a non poche carenze, quantomeno nella 
documentazione, ma ha caratteristiche davvero 
interessanti che certamente ritroveremo nel nostri 
programmi anche, nel bene o nel male, ci 
occupiamo tutto altro che di costruzioni Lego. 

Luigi Corrias 



COME SI AVVIANO I SERVIZI? 
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Services sono creati, avviati 
monitorati e distrutti grazie ad 
un componente software il cui 
nome in codice è Decentralized 
Software Services Node; 
Il nodo DSSIM si occupa anche di 
farli comunicare attraverso un 
protocollo basato su SOAP: DSSP; 
( nota che la l'idea della 
comunicazione tramite SOAP è 
ripresa da uno dei pilastri di .NET, 
i Web Services che si scambiano 
dati appunto su protocollo SOAP 
e WSDL) 

Per creare un Services utilizzando 
DDS non abbiamo che da lanciare 
l'Interfaccia a linea di comando 
del Kit di sviluppo e scrivere: 



dssnewservice /s:NomeServizio 

/LLinguaggio 

e generare, nella cartella di 
installazione del Kit, un vero e 
proprio progetto di Visual Studio 
2005, completo di certificato, 
pronto per essere lanciato e 
programmato(cfr. Fig. 6)! 
Per comodità io ho scelto di 
utilizzare VB.net e di gestire il 
progetto con Visual Studio 2005 
ma, nota bene, questo ambiente, 
se non è utilizzato a scopi 
commerciali, è completamente 
gratuito e può essere 
programmato altrettanto bene 
con i vari Visual Studio Express; 
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TRASFORMAZIONI 
XSLT LATO SERVER 

XSLT CONSENTE DI OTTENERE UN DOCUMENTO IN UN QUALUNQUE FORMATO A PARTIRE DA 
UNA BASE XML AD ESEMPIO DAGLI STESSI DATI SI PUÒ OTTENERE UN FILE .PDF OPPURE UN 
FILE .DOC. IMPARIAMO COME INTEGRARE QUESTA TECNICA CON I LINGUAGGI PIÙ COMUNI 



"& 




QcdQ web 

XSLT_transf.zip 





r-r elementi di Java per il 

Uf, web, PHP5, e Cassie 

Asp, basi di XSL 



. un browser, US, 
' Apache, un SDK 

recente di Java, PHP5, 

Cassie Asp 






Tempo di realizzazione 



Già nel passato, in questa stessa rivista, si 
è molto parlato di XML, con un partico- 
lare risalto agli aspetti più pratici e con- 
creti che caratterizzano questo importantissimo 
formato. 

Si è visto che XML offre grandi vantaggi per lo svi- 
luppatore, a cominciare dalla sua particolare 
struttura, semplice e ordinata, che fornisce 
un'interfaccia "standard" per la gestione e l'or- 
ganizzazione dei dati, in grado di far conciliare 
con successo anche tecnologìe o protocolli 
estremamente diversi tra di loro. 
Oltre ad essere ormai diventato una sorta di 
"lingua franca" per l'informatica, utilizzata da tut- 
te le principali tecnologìe per comunicare vi- 
cendevolmente, XML offre poi qualità di im- 
mediatezza e semplicità interpretativa davve- 
ro eccezionali, che lo rendono il formato di con- 
servazione dei dati ideale anche per i "non ad- 
detti ai lavori". 

L'utilizzo di XML, in particolare, ci consente di 
"disaccoppiare" con facilità la fase di sviluppo ap- 
plicativo (ossia quella legata all'estrazione e al- 
l'elaborazione intermedia dei dati), di compe- 
tenza esclusiva del programmatore, da quella 
meramente rappresentativa, di cui invece si oc- 
cupa il web-designer, ciò avviene utilizzando XSL, 
un linguaggio XML-based che, tramite un pro- 
gramma apposito detto processore XSLT, è in 
grado di trasformare un file XML in un file di 
tutt'altro formato (SVG, XHTML, ecc.). 
Nel passato abbiamo, in particolare, analizzato 
un caso di "trasformazione XSLT lato-client", do- 
ve, cioè, la fase di elaborazione grafica e stili- 
stica dei dati avveniva direttamente sul brow- 
ser. Tale soluzione era caratterizzata dal fatto 
che il server si limitava a consegnare al client 
un semplice file XML con i dati richiesti, e non 
già, quindi, il codice XHTML risultante dall'e- 
laborazione degli stessi. 

Se i vantaggi di questo approccio sono legati ad 
una diminuzione del traffico di rete (visto che 1' "og- 
getto di scambio" tra client e server è un bana- 
le file XML, invece che un codice XHTML com- 



pleto), e ad una riduzione del carico di lavoro 
lato-server, gli svantaggi sono però dovuti alla ne- 
cessità di dover disporre sul client di compo- 
nenti idonei ad effettuare detta trasformazio- 
ne. 

Chi ha già familiarità con lo sviluppo lato-client 
con Javascript immaginerà facilmente, a que- 
sto punto, quanto un simile approccio sìa poco 
realistico se riferito ad un ambiente di produzione, 
dove cioè i potenziali utilizzatori della web-ap- 
plication non necessariamente sono provvisti 
di tutti i requisiti software richiesti. 
L'unica soluzione, pertanto, se l'obiettivo è quel- 
lo di garantire la massima fruibilità del prodot- 
to, è spostare la fase di elaborazione XSLT di- 
rettamente sul server. 

Va precisato, a questo punto, che il presente ar- 
ticolo non si prefigge di trattare in modo com- 
pleto ed esaustivo 1' "argomento XML" nei prin- 
cipali linguaggi lato server, visto che sicura- 
mente non basterebbero diversi volumi. 
Ci limiteremo, piuttosto, ad analizzare gli stru- 
menti che ci vengono messi a disposizione dai 
principali linguaggi lato-server, per l'effettua- 
zione di una semplice trasformazione XSLT. 
A questo riguardo, utilizzeremo il file XML sot- 
to riportato: 

<?xml version="1.0" encoding = "UTF-8"?> 
< progetto 
<fase> 
<descrizione>fase l</descrizione> 



<contenuto> 



<fase> 



<descrizione>fase l_l</descrizione> 



</fase> 



<fase> 



<descrizione>fase l_2</descrizione> 



</fase> 



<fase> 



<descrizione>fase l_3</descrizione> 



<contenuto> 



<fase> 



<descrizione>fase l_3_l</descrizione> 
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<contenuto> 



<fase> 



<descrizione>fase l_3_l_l</descrizione> 



</fase> 



</progetto> 

Si tratta, evidentemente, di un semplice file XML 
che descrive la composizione di un progetto, 
suddiviso in più fasi, le quali a loro volta con- 
tengono ulteriori sotto-fasi, ecc.. 
Tramite il file XSL seguente, siamo in grado di mo- 
dellare la gerarchia delle fasi facenti parte del 
progetto in questione: 

<?xml version = "1.0" encoding = "UTF-8"?> 

<xsl:stylesheet version="1.0" 

xmlns:xsl = "http://www. w3.org/1999/XSL/Transform" 

> 



tiene come elementi la descrizione della fase e 
le eventuali altre sotto -fasi in essa presenti. In al- 
tre parole, il template è applicato in modo ri- 
corsivo per ricostruire l'intera gerarchia delle 
fasi contenuta nel file XML d'origine. 



EFFETTUIAMO 

LA TRASFORMAZIONE 

In precedenza abbiamo introdotto i due file 
XML (il contenitore dei dati da trasformare) e 
XSL (il modello a partire dal quale verrà effet- 
tuata la trasformazione). A questo punto, non ci 
resta che realizzare il "motore" lato-server che 
deve eseguire materialmente l'elaborazione 
XSLT. 

Cominciamo con Asp (Active Server Pages), che 
utilizzeremo nel modo più classico, seguendo 
la logica di programmazione procedurale che 
maggiormente lo caratterizza: 




-0- 



<xsl: template match = "progetto"> 



<html> 



<body> 



<xsl:apply-templates select="fase" /> 



</body> 



</html> 



</xsl:template> 



<xsl:template match = "fase"> 



<ul> 



<li> 



<xsl:value-of select="descrizione" /> 
<xsl:apply-templates select="contenuto/fase" 

/_>_ 

</li> 

</ul> 

</xsl:template> 

</xsl:stylesheet> 

Trascuriamo, in particolare, tutte le problema- 
tiche relative alla creazione dei modelli DTD o 
degli XML Schema, utili per effettuare la vali- 
dazione della definizione semantica dei file 
XML, limitandoci a farne qualche accenno in 
un box a parte. 

Come possiamo vedere, il file XSL parte dal no- 
do principale ("progetto"), e quindi definisce 
un template, ossìa una "regola" che il proces- 
sore XSLT (il programma che deve effettuare la 
trasformazione) deve applicare tutte le volte 
che incontra il nodo "fase" durante il parsing del 
file XML: nel caso in questione, verrà generato 
un tag HTML UL (lista non ordinata), che con- 



<% 



'Dimensioniamo due variabili, che dovranno 

contenere i riferimenti 



ai nostri due file 



Dim objXML 



Dim objXSL 



set objXML = 



Server.CreateObject("Microsoft.XMLDOM") 



objXML.async = false 



set objXSL 



Server.CreateObject("Microsoft.XMLDOM") 



objXSL.async = false 



'carichiamo il file XML 



objXML.Ioad (Server. MapPath("progetto. xml")) 




OME SI INSTALLANO GLI ESEMPI ? 



Ecco le indicazioni per installare i 
file di esempio: 
Asp: basta copiare la cartella 
relativa nel webserver 
(tipicamente MS), e inserire i due 
file XSL e XML nella stessa; 
PHP: occorre copiare la cartella 
con i sorgenti nel webserver 
inserendovi anche i due file da 
processare; 

Jsp: se si usa Tomcat come 
Application Server, è sufficiente 
copiare il file .WAR nella cartella 
Webapps, ove risiedono in 



generale le web-application. 

N.B. Per far funzionare 
correttamente il file indexl.jsp 
(che restituisce lo stesso risultato 
di index.jsp ma ottenuto 
mediante i tag jstl/xml), bisogna 
tuttavìa ricordarsi, prima di 
tutto, di modificare i percorsi 
dei file XSL e XML definiti 
all'interno di essa (per ragioni di 
opportunità di sviluppo la porta 
di ascolto di Tomcat, in tali 
percorsi, è stata fissata in 8084). 
/ 
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-e- 




'carichiamo il file XSL 



objXSLIoad(Server.MapPath("progetto.xsl")) 

'la pagina Asp restituisce il risultato HTML della 

trasformazione 
Response.Write(objXML.transformNode(objXSL)) 



%> 



Inseriamo il file in una directory che vogliamo 
del nostro web-server (tipicamente Internet Infor- 
mation Server) e puntiamo un browser su di es- 
so: come per magìa, l'output HTML della tra- 
sformazione comparirà all'interno della pagi- 
na. 

Vediamo adesso di realizzare lo stesso lavoro 
con PHP, con particolare riferimento alla nuo- 
va versione 5 del linguaggio. 
Per quanto riguarda PHP5, infatti, va detto che 
il nuovo supporto a XSLT, fornito dall'estensio- 
ne XSL, va a sostituire la precedente imple- 
mentazione in PHP4 che faceva riferimento al- 
la libreria Sablotron. Sebbene la grande novità 
di PHP5 (in ambito XML) non sìa propriamen- 
te dovuta alla sua evoluzione nel supporto a 
XSLT (quanto piuttosto all'introduzione dell'e- 
stensione SimpleXml per agevolare l'accesso ai 
tag), è comunque importante sottolineare come 
questo cambiamento segni un vero e proprio 
salto di qualità, almeno rispetto alla preceden- 
te implementazione. 

Ecco qui di seguito una semplice classe PHP5 
che introduce le funzionalità XSLT nella pagi- 
na: 



class xml2xhtml { 



private $file_xml, $file_xsl, $risultato; 



function construct($file_xml, $file_xsl) { 

// è il costruttore della classe, invocato 

automaticamente 
// su creazione di una nuova istanza 



$this->file_xml = $file_xml; 
$this->file_xsl = $file_xsl; 



$this->trasforma(); 



private function trasformaQ { 



// questa funzione, privata, è quella 

// che effettua materialmente la trasformazione 



// E' accessibile soltanto dall'interno della 



classe 



$doc = new DOMDocumentQ; 



$xsl = new XSLTProcessorQ; 



$doc->load($this->file_xsl); 



$xsl->importStyleSheet($doc); 



$doc->load($this->file_xml); 



$this->risultato = $xsl- 



>transformToXML($doc); 



if (!$this->risultato) { 



$this->risultato 



"E' impossibile effettuare la 
trasformazione richiesta"; 




<? 



OSA SONO I MODELLI 
TD E GLI XML SCHEMA ? 



La stesura di un documento XML 
impone in ogni caso il rispetto di 
alcune regole rigide, come la 
necessità di chiudere sempre i 
tag dopo la loro apertura, ecc.. 
E 1 poi anche possibile, da parte 
dello sviluppatore, definire dei 
vincoli validi solo per il 
documento in questione, ai quali 
la struttura del file XML deve 
conformarsi. 

La creazione di un modello DTD 
("Document Type Def inition") 
serve proprio a formalizzare 
questi vincoli, in modo da fornire 
un controllo sulla validità della 
struttura del file XML. 
C'è da dire, tuttavìa, che il 
modello DTD soffre di alcune 
grosse limitazioni (non permette 
di stabilire, ad esempio, il 



numero esatto di occorrenze di 
un dato elemento, o il tipo di 
dato preciso a cui esso fa 
riferimento, ecc.). E' evidente, 
quindi, che tramite questo 
modello possiamo solo limitarci 
a definire in modo rapido e 
conciso un insieme di vincoli 
generici a cui è assoggettato il 
nostro file XML; se tuttavìa è 
necessario un maggiore controllo 
allora occorre utilizzare il XML 
Schema, che rappresenta un vero 
e proprio linguaggio di 
descrizione dei file XML. 
Per approfondire maggiormente 
questi argomenti, consiglio di 
accedere ai seguenti link: 
http://www.w3schools.com/dtd e 
http://www.w3schools.com/sche 
ma . 



function render() { 



// questa funzione, accessibile dall'esterno 
// renderizza nella pagina il risultato della 



// trasformazione 



echo $this->risultato; 



// creiamo una nuova istanza dell'oggetto xml2xhtml 



$transformer = 



?> 



new xml2xhtml('progetto.xml', 

'progetto.xsl'); 



Il file sopra riportato deve essere incluso nella 
pagina di destinazione della trasformazione. 
Per invocare quest'ultima, tuttavìa, occorre ri- 
chiamare il metodo render (), che restituisce 
l'output HTML. 

Vediamo adesso come eseguire lo stesso lavoro 
utilizzando il linguaggio Java. 
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Diciamo subito che per i nostri scopi potremmo 
utilizzare direttamente una servlet, che riceve 
in input gli URL dei file XML e XSL da processare 
e restituisce un risultato. Tuttavìa, così facen- 
do, dovremmo effettuare un'inclusione di tale 
servlet all'interno di una pagina Jsp già esisten- 
te: noi, invece, sceglieremo una via alternativa, 
e decisamente più elegante. Utilizzeremo, in- 
fatti, un componente Javabeans, ossìa una clas- 
se dotata di alcune caratteristiche che fanno 
proprio al caso nostro: 

package xslt.beans; 

import javax. servlet. http. HttpServIetRequest; 
import javax. xml. transform.*; 



import javax. xml. transform. stream. 



import java. io. : 



// permette di impostare l'URL del file XSL 
public void setXslURL(String uri) throws 

MalformedURLException, IOException, 
TransformerConfigurationException { 
xsIFile = factory.newTemplates(openURL(url)); 




} 



private Source openURL(String uri) throws 

MalformedURLException, IOException { 
URL u = new URL(xsltContext + uri); 
return new StreamSource(u.openStream()); 



> 



import java. net. : 



// effettua la trasformazione e ritorna il risultato 

della trasformazione 
public String getOutput() throws 

Transform e rException { 
Transformer trans = xslFile.newTransformer(); 



-e- 



public class xsltJavabean implements Serializable { 
private Source xmlFile; //rappresenta il file xml 
private Templates xsIFile; //rappresenta il file xsl 
private String xsItContext; // rappresenta il 

percorso dei file 



private Transform e rFactory factory; 

// rappresenta il costruttore di trasformatori 



public xsltJavabean() { 

factory = TransformerFactory.newInstance(); 
_> 

public void setContextXslt(HttpServletRequest req) 

{_ 

// solo nell'esempio di questo articolo, imposto 

esplicitamente 
// l'URL dei file xml e xsl; in un caso di 

produzione, tuttavìa, 
// è evidente che i due percorsi possono essere 

rappresentati 
// da qualsiasi tipologìa di URL (anche, ad es., 

file://...) 



// naturalmente, devo passare al bean l'oggetto 

request della jsp 

// come argomento del metodo in questione 

xsItContext = "http://" 

+ req.getServerl\lame() 
+ ":" + req.getServerPort() 
+ req.getContextPathQ + "/"; 



// permette di impostare l'URL del file XML 
public void setXmlURL(String uri) throws 

MalformedURLException, IOException { 
xmlFile = openURL(url); 
} 



StringWriter risultato = new StringWriter(); 
trans, transform (xml Fi le, new 

StreamResult(risultato)); 



return risultato. toStringQ; 



} 



Ed ecco le righe principali della pagina Jsp che 
istanzia il suddetto bean (da notare l'uso dei tag 
Core, facenti parte delle librerie JSTL, grazie ai qua- 
li possiamo evitare di mischiare codice Java con i tag 
HTML, migliorando notevolmente la leggibilità 
anche da parte dei "non programmatori"): 

<jsp:useBean class="xslt.beans. xsltJavabean" 

id = "xslTrasforma" scope="request" /> 
<c:set value="${pageContext. request}" 

target="${xslTrasforma>" property="contextXslt" /> 
<c:set value="progetto.xml" 




OSA SONO I COMPONENTI JAVABEANS ? 



Nell'articolo abbiamo fatto 
riferimento ai JavaBean, per la 
realizzazione del motore XSLT. 
Questi componenti, in realtà, non 
sono altro che semplici classi Java, 
che rispettano però alcune 
caratteristiche di base: 
hanno costruttore pubblico e 
privo di argomenti; 
hanno variabili private e metodi 
pubblici getter e setter per 
ottenere l'accesso alle stesse; 
implementano l'interfaccia 
Serializable (che tuttavìa è priva di 
metodi, serve soltanto al sistema 
per identificare il tipo corretto 
della classe). 



I JavaBean sono utili soprattutto 
per "incapsulare" all'interno di 
componenti riusabili determinate 
logiche applicative: essi offrono 
poi anche altre funzionalità, come 
la possibilità di impostare uno 
scope, ovvero la visibilità del 
componente all'interno della web- 
application. 

Per chi volesse approfondire 
autonomamente lo studio dei 
JavaBean, e più in generale di 
tutto ciò che concerne lo sviluppo 
orientato alla tecnologìa Jsp, 
consiglio il seguente ottimo 
volume: JavaServer Pages di Hans 
BergSten (O' Reilly). 
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interfacciare XSLT con .NET, PHP, JSP.. 




target="${xslTrasforma>" property="xmlURL' 


/> 


<c:set value="progetto.xsl" 

target="${xslTrasforma>" property="xslURL' 


/> 




<h2>Riepilogo delle attività :</h2> 


<c:out value="${xslTrasforma. output}" 

escapeXml = "false' 


/> 



<%@page contentType="text/html"%> 
<%@page pageEncoding = "UTF-8"%> 
<%@taglib 

uri = "http://java.sun.com/jsp/jstl/core" 

prefix="c"%> 
<%@taglib uri = "http://java.sun.com/jsp/jstl/xrnl" 

prefix="x"%> 
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Enrico Viale è specia- 
lizzato nello sviluppo 
di applicazioni sia 
web-oriented che 
desktop. Chi desidera 
contattarlo per chiari- 
menti riguardo all'arti- 
colo, o per qualsiasi 
altro motivo, può 
farlo all'indirizzo enri- 
co.viale@yahoo.it . 



Dicevamo, l'utilizzo di un componente Javabeans 
ci fornisce una serie di agevolazioni: intanto, gra- 
zie ai suoi metodi setter e getter possiamo crea- 
re facilmente proprietà di sola lettura (come out- 
put, definita dal metodo getOutput) o di sola 
scrittura (come xmlURL e xslURL, che derivano 
rispettivamente dai metodi setXmlURL e setX- 
slURL). Il componente può essere istanziato nel- 
la pagina in modo molto semplice, tramite l'a- 
zione <jsp:useBean ... />, e con la stessa facilità 
possiamo anche impostarne le varie proprietà 
(tramite ad esempio i tag Core <c:set ...>) o ri- 
chiedere il valore delle stesse (come nel caso di 
output). Naturalmente i punti di forza dei com- 
ponenti Javabeans non si fermano qui (e questo 
giustifica in pieno la grande diffusione di cui 
essi godono nell'ambito dello sviluppo Java- 
oriented), anche se una trattazione approfon- 
dita dell'argomento andrebbe di sicuro affron- 
tata in ben altra sede. 

Anche la scelta di utilizzare i tag JSTL ci torna 
utile, al fine di evitare l'inserimento di codice 
Java direttamente nella pagina Jsp. A questo 
proposito, è bene ricordare che JSTL, oltre ad 
annoverare la libreria Core (contenente tutte le 
varie funzioni di utilità), include anche altri in- 
siemi di tag, tra i quali quelli legati a Xml, in gra- 
do da soli di erogare funzionalità XSLT all'in- 
terno della pagina. 




OSE SIMPLEXML ? 



Nel testo si è fatto riferimento a 
SimpleXml, la vera grande novità 
introdotta da PHP5 nell'ambito di 
XML. Questa estensione offre un 
accesso notevolmente 
semplificato alle varie 
funzionalità di lettura e scrittura 
di documenti XML. Essa, in 
particolare, tratta la struttura di 
un file XML come un insieme di 
oggetti generati in modo 
automatico e chiamati con il 
nome dei nodi a cui si 
riferiscono: questo approccio 
consente di risparmiare una 
grande quantità di codice 
rispetto invece al metodo 
tradizionale basato sul DOM. 
Ecco un semplice esempio di 



utilizzo di SimpleXml: 



$xml 



simplexml_load_string($xmlstr); 



/* For each <movie> node, we echo 
a separate <plot>. */ 
foreach ($xml-> movie as $movie) { 
echo $movie->plot, '<br 

/>'; 



> 



Maggiori informazioni (e 
ulteriori esempi) sull'uso di 
SimpleXml si possono reperire 
direttamente al seguente sito 
web: http://it2.php.net/simplexml 



<c:import var="xml_filename" 
url = "http://localhost:8084/XSLT_Server/progetto. 

xml 

"/> 

<c:import var="xsl_filename" 
url = "http://localhost:8084/XSLT_Server/progetto. 

xsl" 
/_>_ 

<h2>Riepilogo delle attività:</h2> 
<x:transform xml = "${xml_filename}" 

xslt="${xsl_filename}" /> 

Le poche righe di codice sopra riportate (tra cui 
spiccano, naturalmente, l'importazione della 
libreria di tag jstl/xml e il suo utilizzo median- 
te l'azione x:transform), sono infatti in grado, 
da sole, di operare la trasformazione XSLT rea- 
lizzata in precedenza tramite il componente Ja- 
vabeans. 



CONCLUSIONI 

Nel presente articolo abbiamo analizzato un 
semplice caso pratico di trasformazione XSLT 
lato -server. Non è difficile, a questo punto, com- 
prendere il grande potenziale racchiuso in que- 
sta tecnologìa: grazie ad essa, infatti, possiamo 
ottenere il massimo livello di separazione tra le 
logiche applicative e quelle rappresentative, 
con la garanzia, peraltro, che il prodotto finale 
sarà fruibile da chiunque allo stesso modo, in- 
dipendentemente dai requisiti software della 
piattaforma di destinazione. Tutte caratteristi- 
che che aumentano a dismisura la libertà di 
scelta del programmatore. 
C'è anche da dire, infine, che ormai tutti i linguaggi 
moderni supportano nativamente funzionalità 
avanzate legate a XML, quando addirittura non 
basano totalmente la loro struttura "gramma- 
ticale" su questo formato (mi riferisco ai vari 
XUL di Mozilla, XAML di Microsoft, ecc.). 
Una ragione in più, quindi, per accrescere il più 
possibile la propria conoscenza su questi stru- 
menti, che (c'è da scommetterci) giocheranno 
un ruolo da protagonisti assoluti nel futuro mon- 
do della programmazione. 

Enrico Viale 
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Lo sviluppo di applicazioni grafiche 2D in Java 
non è mai stato semplice. In questo articolo 
introdurremu la libreria Swing- Bug, nata 
all'interno di un blog fhttp://www.blogof bug.com/) e 
poi divenuta un progetto vero e proprio 
fhttps://swing-bug.dev.java.net/ì . Che ci aiuterà a svi- 
luppare interfacce grafiche accattivanti eliminando 
la complessità della tecnologia nativa. 



JCAROUSELMENU 

La componente JCarouselMenu è un estensione di 
javax.swing.JPanel che permette la creazione di un 
originalissimo tipo di menù, suddiviso in due parti: 
quella destra comprendente la lista di voci testuali 
componenti il menù e quella sinistra contenente 
l'immagine associata ad ogni voce. L'azione di cam- 
bio di selezione produce un effetto grafico che fa 
ruotare le immagini sulla sinistra fino a quella relati- 
va all'elemento cliccato. In Figura 1 è visualizzato 
uno screenshot della nostra applicazione di esem- 
pio che fa uso dei JCarouselMenu. 




Figura 1: Visualizziamo le immagini con l'aiuto del 
JCarouselMenu 



La nostra implementazione presenta due bottoni 
nella parte superiore tramite i quali è possibile spe- 
cificare una cartella contenente immagini ed un 
programma per la visualizzazione esterna delle 



immagini stesse. Nella parte centrale è posizionato 
un oggetto di tipo JCarouselMenu creato nel seguen- 
te modo: 

JCarouselMenu carousel = new JCarouselMenu(); 
carousel.setBackground(Color.RED, new Color(255, 0, 

122)); 

Come si può notare il background è costituito da 
due elementi in modo da creare un gradiente pro- 
dotto da due oggetti di tipo java.awt. Color. L'azione 
legata al bottone "Aggiungi Cartella" invoca il 
seguente metodo per popolare il menù: 

public void addFolder(File folder) { 

File[] images = folder.listFiles(newImageFilter()); 
for (File f : images) { 
if (If.isDirectoryO) { 

try{ 

this.carousel.add(new 

ImageAction(f.getName(), f.tollRL(), 

f.getAbsolutePathQ)); 

} catch (MalformedURLException ex) { 
JOptionPane.showMessageDialog(this, 
ex.getMessage(), "Impossibile aggiungere l'immagine 
" + f.getName(), JOptionPane.ERROR_MESSAGE); 
Logger.getLogger("global").log(Level. SEVERE, nuli, ex); 
} 



} 

this.repaint(); 

} 

Il metodo itera su tutti i file di tipo immagine e, per 
ciascuno di essi crea e aggiunge un oggetto di tipo 
ImageAction al JCarouselMenu. 

public class ImageAction extends 

AbstractCarouselMenuAction { 
private String imagePath; 
public ImageAction(String label, URL image, 

String imagePath){ 
super(image,label); 
this. imagePath = imagePath; 
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public void action Performed (Action Event 

actionEvent) { 
System. out.println(actionEvent.getSource()); 



try{ 



java.lang.Runtime.getRuntime().exec("\"" 
+ command + "\" \"" + imagePath+"\""); 



} catch (IOException ex) { 



Logger.getLogger("global").log(Level. SEVERE, 



"Impossibile eseguire il comando " 

+ command + " " + imagePath, 
ex); 



} 



Il metodo actionPerformed viene invocato ad ogni 
doppio click del mouse sulla relativa voce di menù 
ed invoca il tool esterno per la visualizzazione del- 
l'immagine. È possibile cambiare l'applicazione 
esterna tramite il bottone "Apri immagini con ..." il 
default è explorer. 



LAYEREDDOCKPANEL 

Nel gergo informatico il dock è una barra dove si tro- 
vano i collegamenti ad una serie di programmi in 
attesa di essere eseguiti e la sua implementazione 
più conosciuta è quella residente nell'interfaccia 
grafica del sistema operativo MAC OS X, dove le 
icone dei programmi sono dei componenti attivi 
che si ingrandiscono al passaggio del mouse per evi- 
denziare la possibilità di eseguire la relativa applica- 
zione. In Figura 2 è visualizzata l'implementazione 
di tale componente fornita da Swing-Bug. 
La classe che lo implementa è LayeredDockPanel, 
un'estensione di JPanel progettata per essere inseri- 
ta all'interno di un componente di tipo Fraine, in 
rilievo confronto agli altri elementi presenti nel con- 
tainer. Cliccando sul bottone in alto a sinistra viene 



OME INIZIARE 



E indispensabile avere installato 
sul computer Java 2 Standard 
Edition 1.5 o superiore. É 
preferibile utilizzare l'ultima 
versione disponibile dal sito 
http://java.sun.com . 

• Attualmente non è stata 
rilasciata una versione binaria 
(JAR file) della libreria. È 
comunque possibile scaricare i 
sorgenti tramite CVS seguendo 
le istruzioni presenti sul sito del 
progetto ( https://swing- 



bug.dev.java.net/) . 

• Il file swing-bug.zip contiene sia 
l'applicazione di esempio 
presentata nell'articolo sia il 
codice e la documentazione della 
libreria Swing-Bug. Entrambi i 
progetti sono stati creati con 
Netbeans con cui si possono 
facilmente importare. 
Per testare l'applicazione di 

esempio posizionarsi nella cartella 

dist ed eseguire il comando "java - 

jar SwingBugSample.jar". 




Figura 2: II componente dock contenente le nostre 
applicazioni 



mostrato un dialog che consente di specificare una 
nuova applicazione da aggiungere al dock median- 
te il seguente metodo: 

public void addApplication(String name, final String 

command, String image) { 



ImageLabel imgLabel 



new Imagel_abel(new 
Imagelcon(image), 32,32); 



imgLabel. addMousel_istener(newMouseAdapter() { 



@Override 



public void mouseClicked(MouseEvent e) { 



if (e.getClickCountO >= 2) { 



try{ 



java.lang.Runtime.getRuntime().exec("\"" + 



command + "\""); 



} catch (IOException ex) { 



Logger.getLogger("global").log(Level. SEVERE, 

"Impossibile eseguire il comando " + command, ex); 



} 



} 



»; 



this.dockPanel.addDockElement(imgl_abel,name); 



this.repaintQ; 



} 



Il metodo riceve nome, comando e icona dell'appli- 
cazione, crea un oggetto di tipo ImageLabel e lo 
aggiunge al dock invocando il metodo 
addDockElement. Inoltre, aggiunge ad ogni icona un 
listener responsabile di eseguire il comando legato 
all'applicazione. 



JBOOKPANEL 

In questa sezione introdurremo una delle ultime 
novità introdotte nel progetto Swing-Bug: il 
JBookPanel. Si tratta di un contenitore di oggetti di 
tipo javax.swing.JComponent visualizzabili con l'ef- 
fetto libro, ovvero è possibile passare da un compo- 
nente all'altro semplicemente "sfogliando" la pagina 
con il mouse, come visualizzato in Figura 3. 
Per la nostra applicazione di esempio ci siamo limi- 
tati a visualizzare alcune immagini interne al nostro 
JAR file: 

JComponent[] pages = new JComponent[4]; 
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pages[0] = new Jl_abel(new 
ImageIcon(this.getClass().getResource(7it/ioprogram 
mo/example/images/fotol.jpg"))); 
pages[l] = new Jl_abel(new 
ImageIcon(this.getClass().getResource(7it/ioprogram 
mo/example/images/foto2.jpg"))); 
pages[2] = new JLabel(new 
ImageIcon(this.getClass().getResource(7it/ioprogram 
mo/example/images/foto3.jpg"))); 
pages[3] = new JLabel(new 
ImageIcon(this.getClass().getResource(7it/ioprogram 
mo/example/images/foto4.jpg"))); 

JBookPanel bookPanel = new JBookPanel(); 
bookPanel.setPages(pages, 262, 350); 

bookPanel. setMargins(30, 40); 
bookPanel. setBackground(new Color( 157, 185,235)); 
bookPanel. setSoftClipping(true); 
bookPanel. setBorderLinesVisible(true); 



if (!e.getValueIsAdjusting()){ 



if (reflectBox.isSelectedO) { 



EffectsContainer.this.addEffect(new 

ReflectEffect(new ListCellBurst(list, 
list.getSelectedIndex()), EffectsContainer.this)); 



} else { 



EffectsContainer.this. addEffect(new 
ListCellBurst(list, list.getSelectedIndex())); 



} 



} 



Notare che, nel caso in cui la checkbox "Reflect" sia 
selezionata l'effetto ListCellBurst viene inglobato 
all'interno di un oggetto ReflectEffect responsabile di 
creare un effetto specchio. Inoltre, nella parte cen- 
trale dello schermo è stato utilizzato un effetto di 
tipo ParticleEffect che, sul movimento del mouse, 
produce una reazione simile a quella delle particelle 
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Figura 3: JBookPanel utilizzato come album 
fotografico 



In questo paragrafo vedremo come sia possibile 
inserire semplici effetti animati utilizzando i metodi 
messi a disposizione delle API di Swing-Bug. 
Attualmente, la libreria contiene 18 differenti effetti, 
alcuni utilizzabili singolarmente altri annidabili tra 
di loro, che implementano l'interfaccia Effect e che 
si possono applicare unicamente su oggetti di tipo 
EffectsPanel: una specifica estensione di JPanel. 
In Figura 4 è visualizzata l'applicazione di esempio 
contenente una serie di effetti grafici. 
Nella parte sinistra è stato posizionato un oggetto di 
tipo javax.swing.JList, a cui è stato aggiunto un lis- 
tener che si occupa di scatenare un effetto di tipo 
ListCellBurst al cambio di selezione. Questo effetto 
produce "un'esplosione" del testo contenuto nell'e- 
lemento selezionato che si propaga all'interno della 
finestra. 



• Reflect Show faile 

Lista Riviste 

ioProfjrammo 
Linux Magazine 
Internet Magazine 
Computer BilcJ Italia 
Office Magazine 
Quale Computer 



Figura 4: Una dimostrazione di alcuni effetti grafici 

su cui incide la forza di gravità. 

public void mouseMoved(Point position) { 
Effect theEffect = nuli; 

if (Math.randomQ > 0.5) { 

theEffect = new ParticleEffect(starSmall, 

(int) position. getX(), (int) position. getY(), 40, 
(this.getHeight() / 3) * 2); 



} else { 



theEffect = new ParticleEffect(star, (int) 

position. getX(), (int) position. getY(), 40, 
(this.getHeight() / 3) * 2); 



if (this. reflectBox.isSelectedO) { 



this.addEffect(new ReflectEffect(theEffect, 



this)); 



} else { 



this.addEffect(theEffect); 



public void valueChanged(ListSelectionEvent e) { 



Fabrizio Fortino 
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GESTIONE DEI 
DATI CON I FRAME 

IL COLLEGAMENTO XMLHTTPREQUEST NON È IL SOLO MODO DI REPERIRE I DATI DA 
ELABORARE IN JAVASCRIPT, VEDREMO ALL'OPERA UNA TECNICA CHE CI CONSENTE DI FARE 
A MENO DEL LATO SERVER E DI PROGETTARE APPLICAZIONI OFF-LINE 
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Più volte abbiamo scritto sulle modalità 
di recupero dei dati dal server in appli- 
cazioni Web di tipo AJAX : si effettua 
una chiamata XMLHttpRequest, il server ela- 
bora una risposta utilizzando un linguaggio di 
programmazione come PHP, ASP, Java ecc.. e 
restituisce una stringa con i dati (in formato 
XML, JSON o altro) che il client elaborerà 
secondo il flusso del programma. 
Questa volta però vedremo un'altra tecnica di 
recupero dati, la Hidden Frame, che ci con- 
sentirà addirittura di fare a meno del tutto di 
pagine che utilizzino un linguaggio di pro- 
grammazione lato server! 



IL PRINCIPIO DI BASE 



<bodyx/body> 



La tecnica della Hidden Frame si basa appun- 
to in una <FRAME> o <IFRAME> nascosta 
dove verranno caricati i dati in forma di Array 
od oggetto Javascript. 

La cosa è più semplice a comprendere veden- 
do un semplice esempio. 
Poniamo di avere scritto, in un file che chia- 
meremo data.js, i dati di un anagrafica ad 
esempio come Array di Array: 

var anagrafica = [ 





['Mario', 'Rossi', 'Via Verdi 10',' Milano'], 




['Antonio', 'Bianchi', 'Via Leopardi 1', 'Genova'] 






— REQUISITI V 


Adesso creeremo una pagina web, che chia- 




j"T Javascript a livello 
- medio 


meremo data.html, che serve solo come "con- 
tenitore" del file di dati che verrà incluso 
come risorsa Javascript esterna: 


■ 


<html> 


F/777*7?*7i7»! 


<head> 


é=3 isj isi __j __j 


<script src="data.js" 

type="text/javascript"x/script> 


SS"™" 


</head> 



</html> 

Aggiungeremo a questo punto, al codice html, 
del codice Javascript che, dopo il caricamento 
della pagina, eseguirà una funzione: 



<scr 


pt 


language 


= "java se 


ript" 
type= 


"text/javascript"> 






window.onload = 


function () { 


try{ 


top.loadEnd(window); 


} 








catch(e 


){} 




} 


</sc 


-ipt 


> 









Notate però che la funzione IoadEnd non 
viene richiamata nella pagina stessa, ma nella 
pagina superiore (top). Questo perché la 
pagina data.html, che contiene l'Array di dati, 
è destinata ad essere inserita in una <IFRA- 
ME> di una pagina contenitore (referenziata 
appunto dall'oggetto top). Una cosa che a 
volte ci dimentichiamo è infatti che le varie 
finestre o frames in Javascript possono comu- 
nicare (a condizione di essere tutte prove- 
nienti dallo stesso sito), è insomma possibile 
da una finestra richiamare funzioni o utilizza- 
re variabili contenute in un'altra finestra. 
Questa particolarità nel nostro caso ci torna 
molto utile: poniamo infatti il caso che la 
pagina data.html (che a sua volta include il 
file data.js) abbia, considerato l'Array, una 
dimensione di diverse centinaia di Kb, la pagi- 
na contenitore mostrerà allora un messaggio 
di caricamento dati finché data.html non sarà 
stata del tutto caricata, a quel punto dalla 
stessa data.html verrà richiamata la funzione 
IoadEnd della pagina contenitore ed i dati 
potranno cominciare ad essere utilizzati. 
Vediamo quindi, sinteticamente, come viene 
strutturata la pagina che contiene l'<IFRA- 
ME> (che poi sarà quella che contiene la 
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nostra applicazione): 



-0- 



<html> 



<head> 



</head> 



<div id = "wait"> 



Attendere, caricamento dati in 



</div> 



<iframe id = "dataFrame" width = "0" 
height="0" src="data.html" frameborder="0"> 



</iframe> 



<div id = "main" style="display:none"> 



Interfaccia applicazione 



</div> 



</html> 

Abbiamo cioè due <DIV> di cui il secondo è 
nascosto tramite l'attributo CSS display e una 
<IFRAME> di dimensioni e bordo a 0, quindi 
invisibile, che carica data.html, la pagina con- 
tenente i dati. Nello stato iniziale sarà quindi 
visibile solo il <DIV> contenente il messaggio 
di attesa. Inseriamo allora la funzione 
IoadEnd che verrà richiamata dall' <IFRAME> 
al termine del caricamento : 

<script language="javascript" 

type="text/javascript"> 
function IoadEnd (srcWindow){ 

} 

</script> 

Nel corpo della funzione scriviamo prima il 
codice necessario a nascondere il <DIV> con il 
messaggio di attesa e a mostrare l'altro <DIV>: 



var divi = document.getElementById("wait"); 
var div2 = 

document.getElementById("iTiain"); 
divi, style. display = "none"; 
div2.style. display = ""; 



poi recuperiamo i dati rappresentati dalla 
variabile anagrafica dichiarata a livello di 
<IFRAME> e li assegniamo a una variabile 
locale dallo stesso nome (ricordiamoci che la 
finestra di <IFRAME> è qui rappresentata dal- 
l'argomento srcWindow della funzione 
IoadEnd) : 

var anagrafica = srcWindow. anagrafica; 

Quindi possiamo utilizzare i dati, ad esempio 



per creare una lista di nomi: 



var s = "<h3>DATI:</h3>"; 

for(var i = 0; ^anagrafica. length;i + + ){ 

var rowPersona = anagrafica[i]; 
s += "<li>" + 
rowPersona.join(" ") + "</li>" 

_} 

div2.innerHTML = s; 



Eseguendo la pagina in un browser avremo 
quindi dapprima il messaggio di attesa di cui 
in figura 1, quindi il risultato dell'utilizzo dei 
dati di cui alla figura 2. 



miMMimm 



File Modifica Visualizza Cronologia Segnalibri Strumenti ? 



tj& j_4| |D http://localhost:1717/esempio,html | ▼ 



Disable ' 



> CookJes * | CSS * dJ Forrms - 8 images * 



Attendere, caricamento dati in corso . 



Fig. 1: Messaggio di attesa 



Disable - o CookJes T I CSS T li_| Forms T Images T __) Information - 
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x- 



I fiù ì± | D http://localhost:1717/esempio,html 



DATI: 

+ Mano Rossi Via Verdi 10 Milano 

* Antonio Bianchi Via Leopardi 1 Genova 



Fig. 2: Caricamento completato 



UTILITÀ DELLA 
TECNICA 

Ma quand'è che questa tecnica di Storage e 
recupero dei dati può essere utile? 
La tecnica dell'Hidden Frame rappresenta 
una risorsa preziosa in alcune condizioni: 

• si ha a che fare con una (relativamente) 
limitata quantità di dati (es. catalogo pro- 
dotti, foto gallery, listini prezzi ecc..) 

• i dati cambiano poco spesso (così da bene- 
ficiare del caching del browser) 

• si vuol rendere indipendente l'applicazione 
da un linguaggio lato server oppure si pre- 
vede di distribuire l'applicazione anche off- 
line 



DAL DB ALL'ARRAY 
JAVASCRIPT 

C'è però un problema che alcuni si saranno a 
questo punto posti : se i dati sono contenuti in 
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AMCHE 
CON XML 

Un altro modo per 

ottenere un Array 

Javascript da una 

tabella è esportarla in 

formato XML e 

trasformarla mediante 

uno stylesheet XSLT. 

Nel codice allegato è 

riportato un esempio 

sia del file di dati XML 

prodotto da 

un'esportazione da 

Access 2007 che dal 

file XSL che può essere 

usato per produrre 

l'array. 



origine in un database come fare a trasfor- 
marli in un array Javascript? 
Certo si potrebbe anche scrivere una piccola 
utility di trasformazione da una tabella di DB 
ad un array, ma c'è anche un altro "trucchet- 
to" abbastanza ingegnoso: 

1. esportiamo la tabella in un foglio di Excel 
eliminando la prima riga se contiene l'inte- 
stazione 

2. mettiamo che i dati siano nelle prime tre 
colonne del foglio (A,B e C) ci portiamo 
nella colonna D della prima riga contenen- 
te i dati e scriviamo una funzione di conca- 
tenazione di stringhe come: 

= "['" & Al & "','" & Bl & "','" & CI & "']," 

Il risultato sarà l'array che rappresenta la 
riga,ad esempio: 

['Mario Rossi', 'Via Verdi 10',' Milano'], 

3. copiamo la funzione nelle celle successive 
della colonna D ottenendo così, nella 
colonna D, gli Array corrispondenti alle 
righe 

4. a questo punto basta copiare il contenuto 
delle celle della colonna D in un editor di 
testo: 



['Mario', 'Rossi', 'Via Verdi 10',' Milano'], 
['Antonio', 'Bianchi', 'Via Leopardi 1', 'Genova'], 

eliminare l'ultima virgola: 



SOSTITUISCI(Bl;'"";"\'") & "','" & 
SOSTITUISCI(Cl;'"";"\'") & "']," 



LA PROVA SU 
STRADA: CALCOLO DEL 
CODICE FISCALE 

È arrivato quindi il momento di applicare la 
tecnica dell'Hidden Frame ad un caso reale, 
per questo scegliamo il calcolo del codice 
fiscale, così, oltre che prendere confidenza 
con la tecnica, ci ritroveremmo ad avere 
anche una piccola applicazione di una certa 
utilità pratica che può essere usata anche off- 
line. 

L'algoritmo di calcolo del codice fiscale non è 
difficile (dopo lo vedremo) il problema è che 
richiede un codice corrispondente al comune 
di nascita della persona (es. per Milano F205, 
Roma H501 e così via) quindi, tra comuni e 
stati esteri, abbiamo una tabella (e il conse- 
guente array) di oltre 8000 righe. 
L'esportazione della tabella dei codici comu- 
ni in un array Javascript produce un file di 248 
Kb: si tratta di un caso un po' limite per usare 
la tecnica dell'Hidden Frame (ricordiamoci 
che il client scarica comunque tutti questi 
dati), comunque ancora può andare... 
L'applicazione consisterà in una form dove ci 
sono delle textbox per nome e cognome, una 
select M/F per il sesso, un controllo DateBox 
per la data di nascita e un controllo 
Autosuggest per il comune di nascita. 



['Mario', 'Rossi', 'Via Verdi 10',' Milano'], 
['Antonio', 'Bianchi', 'Via Leopardi 1', 'Genova'] 

e racchiudere il tutto tra le parentesi quadre 
assegnando l'array ad una variabile: 



var myArray = [ 

['Mario', 'Rossi', 'Via Verdi 10',' Milano'], 

['Antonio', 'Bianchi', 'Via Leopardi 1', 'Genova'] 

]; 



Attenzione però, poiché la destinazione deve 
essere un codice valido in Javascript, e noi 
abbiamo usato il carattere di virgoletta singo- 
la come separatore, la funzione Excel dovrà 
prevedere il replace del carattere di virgoletta 
singola " ' " eventualmente presente nel testo 
con l' escape " V ", la funzione completa 
sarebbe quindi : 

= "['" & SOSTITUISCI(Al;'"";"\"') & "','" & 



L'INTERFACCIA 
UTENTE 

Parlando di "controlli" DateBox e 
Autosuggest non mi riferisco naturalmente a 
elementi HTML particolari, ma ad elementi 
standard HTML (Input, Select ecc..) per cui 
del codice Javascript definisce particolari 
comportamenti. 

Un esempio classico è l'Autosuggest che non 
è altro che un normale elemento <INPUT> al 
quale viene associata un'azione sull'evento 
onkeyup che consiste nel mostrare una lista 
di suggerimenti in un <DIV> posizionato al di 
sotto dell'elemento. Ebbene, quello che si 
definisce "controllo" è l'insieme di codice 
Javascript, CSS e HTML necessario a far com- 
portare uno o più elementi HTML in un certo 
modo. 

Nel tentativo di dare organicità a quell'insie- 
me di tecnologie che comprendono lo svilup- 
po web su lato client, dette anche AJAX, WEB 
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2.0 ecc., stanno fiorendo numerosi ed. fra- 
meworks Javascript (Yahoo! User Interface 
Library, Rico, Qooxdoo, Dojo ecc.). 
Lo scopo di tali frameworks e spesso quello di 
offrire al programmatore un abstraction layer 
che consenta di non curarsi delle differenze 
dei vari browser, e mettere a disposizione dei 
controlli già pronti che mimano quelli che 
più spesso si trovano nei sistemi operativi 
(tabs, tree-view, dateBox, autocomplete 
ecc.). 

Non nego che a volte la tentazione di ricorre- 
re ad un framework che offre un'abbondante 
scelta di GUI (Graphic User Interface) già 
pronta può essere forte, tuttavia c'è un rove- 
scio della medaglia che alcune volte non si 
considera adeguatamente: Talvolta la dimen- 
sione del framework è superiore a quella del 
progetto, ad esempio: utilizzando come con- 
trollo Autosuggest quello presente nella YUL 
(Yahoo! User Interface Library) la dimensione 
complessiva degli script da includere nella 
pagina sarebbe stata di 183 Kb, mentre utiliz- 
zando un Autosuggest "fatto in casa" tutto il 
codice sta in un file di 12 Kb! Circa 15 volte 
meno! 

A questo punto è evidente che la nostra scel- 
ta sarà quella di utilizzare, per DateBox, e 
Autosuggest, due script che ci siamo auto- 
costruiti. Nel progetto allegato al CD trovere- 
te i due scripts completi, quello che a noi 
interessa, in questa fase, è vederne l'utilizzo 
pratico. 

Entrambi si basano sull'aggiunta di funziona- 
lità a elementi esistenti nel codice HTML. 
Per il DateBox avremo un elemento che con- 
tiene tre <INPUT> che rappresentano gior- 
no,mese ed anno, ad esempio : 



dataNasc = new DateBox(oContainer); 



<td id = "dtNasc"> 


<input type="text" maxlength = "2" 
class="datePart" id = "day" 


name 


= "day' 


> 


/ 


<input type="text" maxlength = "2" 

class="datePart"id = "month" name="imonth' 


> 


/ 


<input type="text" maxlength = "4" 
class="datePart" id = "year" 


name= 


:"year' 


> 


</td> 



La definizione di questo complesso di ele- 
menti come DateBox e l'aggiunta delle fun- 
zionalità corrispondenti avviene, sul versante 
del codice Javascript, attraverso l'istanza di 
un nuovo oggetto: 

var oContainer = 

documenti. getElementById("dtNasc"); 



Data d 


i nascita 




2 


/25 


/2007 



Fig. 3: Controllo DateBox con valore errato 



Data di nascita 

2 11 /2007 



Fig. 4: Controllo DateBox con valore esatto 

Le funzionalità che vengono aggiunte sono: 

• Controllo correttezza nella digitazione e 
segnalazione visiva (il contenuto delle text- 
box apparirà in rosso se i tre valori non 
sono una data valida, verde se lo sono). 

• Proprietà value dell'oggetto DateBox che 
rappresenta un oggetto di tipo Date o nuli. 

Abbastanza semplice è anche l'utilizzo di 
Autosuggest dove il codice HTML su cui si 
applica il controllo è: 

<input type="text" id = "luogoNasc"/> 

e il costruttore Javascript sarà: 

codComuneAutocomplete = new 

AutoSuggestControl( 
document.getElementById("luogoNasc"), 

new CodeSuggestion(), 

{width:400} 

); 
i tre argomenti forniti sono: 

1. Riferimento all'elemento <INPUT> su cui si 
installa l'Autosuggest 

2. Un oggetto che deve contenere il metodo 
getArray che deve restituire l'array di strin- 
ghe da mostrare nel box sottostante dato 



Luogo di nascita 


Afflila r Estero 


AGLIE^ (TO) 
AIRASCA (TO) 
ALA DI STURA (TO) 
ALBIANO DTVREA (TO) 
ALICE SUPERIORE (TO) 
AL ME SE (TO) 
AL RETTE (TO) 
ALPIGNANO (TO) 
AND EZENO (TO) 




Fig. 5: Controllo Autosuggest in azione 



http://www.ioprogrammo.it 



Ottobre 2007/ 43 ► 



040-047:032-035 31-08-2007 16:08 Pagina 44 



ioProgrammo Web T I Pagine più veloci con i frame nascosti 





-& 



ALGORITMO 

DI CALCOLO 

DEL CODICE 

FISCALE 

All'indirizzo 

http://it.wikipedia.org/ 

wiki/Codice fiscale 

troviamo una 

spiegazione 

dettagliata ed 

esauriente 

dell'algoritmo di 

calcolo del codice 

fiscale. 



un valore di confronto passato come argo- 
mento, nel nostro caso ad esempio la strut- 
tura del metodo sarà: 

CodeSuggestion.prototype.getArray = 

function (searchValue){ 
var aSuggestions = []; 

.. //composizione dell'array 



return aSuggestions; 



} 



3.11 terzo argomento è invece un oggetto con- 
tenente le opzioni di configurazione (attual- 
mente limitate alla sola proprietà width 
ovvero la larghezza del box dove appaiono i 
valori, ma configurata come oggetto in 
modo da garantire una maggiore flessibilità 
in caso di modifiche future) 

Alla fine l'interfaccia utente sarà quella 

mostrata in figura 6 
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Luogo di nascita 


F Estero 
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Fig. 6: l'interfaccia utente 

con una <IFRAME> nascosta dove vengono 
caricati i dati ed uno splash screen iniziale di 
attesa caricamento che possiamo vedere in 
figura 7 
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F/g. 7: Splash screen iniziale 



CALCOLO 

DEL CODICE FISCALE 

Vediamo adesso l'algoritmo vero e proprio di 
calcolo del codice fiscale. 
Cognome (3 lettere) - si prendono le prime 
tre consonanti del cognome (ad esempio SML 
per SMELZO), se le consonanti sono insuffi- 
cienti si prelevano anche le vocali, sempre nel 



loro ordine (ad esempio RAA per ARA); se 
anche le vocali sono insufficienti si usano le X 
(ad esempio BOX per BO). 
Nome (3 lettere) - vengono prese la prima, la 
seconda e la quarta consonante del nome (ad 
esempio FNC per FRANCESCO), se le conso- 
nanti sono meno di quattro le tre, se non sono 
sufficienti si prendono anche le vocali in 
maniera analoga a quanto visto con il cogno- 
me. 

Anno di nascita (2 cifre) - si prendono le 2 
ultime cifre dell'anno di nascita 
Mese di nascita (1 lettera) - si trasforma il 
mese di nascita in lettera secondo la tabella: 



Lettera 


Mese 


Lettera 


Mese 


A 


gennaio 


L 


luglio 


B 


febbraio 


M 


agosto 


C 


marzo 


P 


settembre 


D 


aprile 


R 


ottobre 


E 


maggio 


S 


novembre 


H 


giugno 


T 


dicembre 





Giorno di nascita (2 cifre) - si prendono le 
cifre del giorno di nascita (se è un numero 
fino a 9 si antepone uno 0), per le donne si 
somma a tale numero 40. 
Comune di nascita (4 caratteri alfanumerici) 
- si prende il codice corrispondente al comu- 
ne (o allo stato estero) di nascita composto da 
una lettera e 3 cifre numeriche. 
Codice di controllo (1 lettera) - Partendo 
dai 15 caratteri ricavati in precedenza, si cal- 
cola il codice di controllo: da una parte si met- 
tono i caratteri alfanumerici che si trovano in 
posizione dispari (il 1°, il 3°, ecc.) e da un'altra 
quelli che si trovano in posizione pari (il 2°, il 
4°, ecc.). Questi caratteri vengono convertiti 
in numeri utilizzando le seguenti tabelle: 
A questo punto tutti i valori vengono somma- 



Carattere 


Valore 


Carattere 


Valore 


Carattere 


Valore^ 





1 


C 


5 


O 


11 


1 





D 


7 


P 


3 


2 


5 


E 


9 


Q 


6 


3 


7 


F 


13 


R 


8 


4 


9 


G 


15 


S 


12 


5 


13 


H 


17 


T 


14 


6 


15 


I 


19 


U 


16 


7 


17 


J 


21 


V 


10 


8 


19 


K 


2 


W 


22 


9 


21 


L 


4 


X 


25 


A 


1 


M 


18 


Y 


24 


B 





N 


20 


Z 


23 


CARATTERI ALFANUMERICI DISPARI 
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Carattere 


Valore 


Carattere 


Valore 


Carattere 


Valore 








C 


2 


O 


14 


1 


1 


D 


3 


P 


15 


2 


2 


E 


4 


Q 


16 


3 


3 


F 


5 


R 


17 


4 


4 


G 


6 


S 


18 


5 


5 


H 


7 


T 


19 


6 


6 


I 


8 


U 


20 


7 


7 


J 


9 


V 


21 


8 


8 


K 


10 


W 


22 


9 


9 


L 


11 


X 


23 


A 





M 


12 


Y 


24 


B 


1 


N 


13 


Z 


25 


CARATTERI ALFANUMERICI PARI 



ti e divisi per 26, il resto della divisione verrà 
convertito in carattere utilizzando questa 
tabella: 



r Resto 


Lettera 


Resto 


Lettera 


Resto 


Lettera 





A 


9 


J 


18 


S 


1 


B 


10 


K 


19 


T 


2 


C 


11 


L 


20 


U 


3 


D 


12 


M 


21 


V 


4 


E 


13 


N 


22 


W 


5 


F 


14 


O 


23 


X 


6 


G 


15 


P 


24 


Y 


7 


H 


16 


Q 


25 


Z 


. 8 


I 


17 


R 









IMPLEMENTAZIONE 
DELL'ALGORITMO 
IN JAVASCRIPT 

Per implementare il calcolo del codice fiscale 
in Javascript abbiamo realizzato un file sepa- 
rato (presente nel codice allegato con il nome 
codice Fiscale.js) dove per prima cosa andre- 
mo a estendere alcuni oggetti base come 
String e Date con funzioni che successiva- 
mente ci saranno utili; riportiamo le intesta- 
zioni delle funzioni di estensione : 

String. prototype.isVocal = function (){ 
//determina se il primo carattere della stringa è 

una vocale 
// es. "a".isVocal() [true] 

_} 

String. prototype.toCharArray = function (){ 
//restituisce l'array di caratteri che compongono 

la stringa 



} 



String. prototype.extractLetters = function 

(typel_etter,casing){ 



estrae tutte le lettere dalla stringa come array di 

caratteri escludendo 
i caratteri che non sono lettere come backspace, 

tab, spazi ecc.. 
typeLetter può essere "v" o "e" per estrarre solo 

vocali o solo consonanti 
casing può essere "u" o "I" per ottenere lettere 

tutte maiuscole o tutte minuscole 

V_ 

} 



String. prototype. pad Left 



function 

(padChar,padl_en){ 



/* 




aggiunge dei caratteri di riempimento a sinistra 

della stringa, ad esempio "1" diventa "01" 
padChar è il carattere da usare come riempimento 
padLen è la lunghezza complessiva che dovrà 

avere la stringa compresi i caratteri di 
riempimento 
*/ 



Definiamo quindi il prototipo dell'oggetto, 
che racchiuderà tutte le funzionalità di calco- 
lo, che chiameremo CodiceFiscale: 

function CodiceFiscale 

(nome, cognome, sesso, codComune, datal\lasc){ 

this.nome = nome 1 1 "; 

this. cognome = cognome || "; 

this. sesso = ((sesso || 'M') = = 'M')?'M':'F'; 

this.codComune = codComune; 

this.dataNasc = dataNasc; 
} 



Com'è facile intuire nel costruttore vengono 
passati anche i dati occorrenti al calcolo. Per 
controllare meglio i dati di input prevederemo 
anche un metodo di creazione dell'istanza 
che effettua anche i controlli sui dati e solleva 
eventuali eccezioni: 

CodiceFiscale. createlnstance = function 

(nome, cognome, sesso, codComune, dataNasc){ 

_r 

N.B. Le varie funzioni di controllo come 



OTA SUGLI ESEMPI PRESENTI 
NELL'ARTICOLO 




Negli esempi di codice che troverete 
nell'articolo vengono usate alcune 
funzioni come isNull, isNulString,$(), 
l'oggetto $E ecc.. 

Si tratta di funzioni ed oggetti defi- 
niti in una piccola libreria che l'auto- 
re ha sviluppato (una specie di Pro- 
totype, ma limitato all'essenziale) il 



cui scopo è fornire alcuni metodi di 
utilità (come isNull ecc..) non pre- 
senti in Javascript oppure delle scor- 
ciatoie sintattiche (come $("ele- 
ment") invece di document.getEle- 
mentByldC'element") ). 
Questa libreria, chiamata Core.js, è 
allegata al codice d'esempio 



/* 
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isNullString ecc.. sono definite altrove 

/ 

var missingData = 'Manca dato:{0}'; 
var badData = 'Dato non conforme: {0}'; 
if (isNullString(nome)) throwError(l, 

missi ng Data. printf(' Nome')); 
if (isNullString(cognome)) throwError(l, 

missingData.printf('Cognome')); 
if (isNullString(codComune)) 
throwError(l, m issi ng Data. printf('Cod ice 

Comune')); 
if (isNullString(sesso)) throwError(l, 

missingData.printf('Sesso')); 
if (isNull(dataNasc)) throwError(l, 

missingData. printf('Data di nascita')); 

if (!/\w{l}\d{3}/.test(codComune)) 

throwError(2, badData. printf('Codice Comune')); 

if (!/(M|F){l}/.test(sesso)) throwError(2, 

badData.printf('Sesso')); 

if (MsDate(dataNasc)) throwError(2, 

badData. printf('Data di nascita')); 
return new CodiceFiscale 
(nome, cognome, sesso, codComune,datal\lasc); 



A questo punto iniziamo con le funzioni per 

l'elaborazione del codice fiscale. 

Iniziamo dalla parte che riguarda il cognome: 

CodiceFiscale. prototype.getCognomePart = 

function (){ 
var consonants = 

this. cognome. extractl_etters('c','u'); 
var vocals = 

this. cognome. extractl_etters('v','u'); 
return ( 
consonants.concat(vocals,['X','X','X']) 
).slice(0,3).join("); 



In pratica si crea un array che contiene di 
seguito prima le consonanti, poi le vocali e 
infine 3 caratteri "X" e si ritornano i primi tre 
caratteri uniti in una stringa. 
Analogamente si procede con il nome tenen- 
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Calcolo codice fiscale 




Nome Cognome 
Gianni Gialli 
Data di nascita Sesso 
4 H /1972 [m"3 

Luogo di nascita 

|B0L0GNA r Estero 


Nome Cognome Sesso Data Naso 


Luogo Nasc. Cod. Fise. 


Mario Rossi M 2/4/1939 
Franca Bianchi F 5/8/1960 
Gianni Gialli M 4/7/1972 


TORINO RSSMRA39E02L219W 
NAPOLI BNCFNC60P40F839M 
BOLOGNA GLLGNN72M03A944R 










«1 


1 H 


| Completato 


■filo 



do presente che qui dovremo ordinare le con- 
sonanti mettendo la terza e la quarta prima 
della seconda: 



CodiceFiscale. prototype.getNomePart = function 



(){ 



var consonants = 

this. nome. extractl_etters('c','u'); 



var vocals 



this. nome. extractLetters('v'/u'); 



var ordered = []; 



var rest = []; 



for(var i = 0;i<consonants.length;i + + ){ 



if(i = = 0||i = = 2||i = = 3) 

ordered. push(consonants[i]); 



else rest.push(consonants[i]); 



return ( 



ordered. concat(rest,vocals,['X','X','X']) 



).slice(0,3).join("); 



} 



Per ragioni di spazio riportiamo solo la 
dichiarazione delle altre funzioni che sono: 



CodiceFiscale. prototype.getDatePart = function 



(){ 



/* 



Recupera la parte Giorno Mese e Anno del codice 

fiscale 



*/ 



} 



CodiceFiscale. prototype.getControlChar = function 

(s){ 



/* 



Calcola il carattere di controllo finale 



*/ 



} 



Il risultato sarà dato dal metodo toStringO che 
non farà altro che assemblare i risultati degli 
altri metodi: 



Cod 


ceFiscale.prototype.toString = function 


(){ 




var result 










result + = 


this 


getCognomePart(); 






result + = 


this 


getl\lomePart(); 






result + = 


this 


getDatePart(); 






result + = 


this 


codComune; 






result + = 


this 


getControlChar(resu 


it); 


return result; 


} 



Fig. 8: Risultato finale 



Nella pagina che ospita l'applicazione utiliz- 
zeremo l'oggetto CodiceFiscale passandogli i 
dati che derivano dall'interfaccia utente: 
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function eseguiCalcolo (){ 



td 



/* N.B. $E è un helper definito altrove */ 



tr.insertCell(-l); 
td.innerHTML= 



cf.sesso; 



var cf = nuli 



cf= 



CodiceFiscale.createlnstance ( 



$E.value('nome'), 



$E.value('cognome'), 



$E.value('sex'), 



codComuneAutocomplete.value.code, 



dataNasc.value) 



); 



addResult(cf); 



} 
Il metodo eseguiCalcolo passa poi l'oggetto 
creato alla funzione addResult che, in questo 
caso, utilizza l'oggetto per creare la riga di una 
tabella: 

function addResult (cf){ 

$E.show("result"); 

var oTable = $("resultTable"); 



var td, tr 



oTable.insertRow(- 

i); 



td = tr.insertCell(-l); 

td.innerHTML= cf.nome; 



td = tr.insertCell(-l); 

td.innerHTML= cf.cognome 



} 



In figura 8 possiamo vedere il risultato finale 
della nostra applicazione con la tabella alla 
quale vengono appese le nuove righe con i 
codici fiscali calcolati. 



CONCLUSIONI 

La tecnica non è certo paroganabile ad Ajax, 
che nasconde in se una complessità decisa- 
mente più elevata ed un numero di opportu- 
nità sicuramente maggiore, tuttavia sicura- 
mente rappresenta un ottimo workaround 
quando si devono caricare elevate quantità di 
dati in una pagina HTML. Certo è necessario 
comprendere a fondo la logica con cui i vari 
frame sono innestati, tuttavia questo può rap- 
presentare solo un ostacolo iniziale, una volta 
compreso lo schema di funzionamento delle 
varie pagine, può essere utilizzato come 
modello per un numero veramente elevato di 
casi. 

Francesco Smelzo 
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Lo scopo del presente articolo è quello di 
realizzare una soluzione di tracciamento 
che possiamo schematicamente osservare 
nella Figurai. 

Nella prima parte dell'articolo abbiamo descrit- 
to l'applicazione mobile installata su di un 
dispositivo che monta il sistema operativo 
Windows Mobile 5 o Windows Mobile 6 e dotato 
di una antenna per la ricezione delle informazio- 
ni satellitari. Abbiamo altresì analizzato la strut- 
tura del web service a cui vengono inviate le 
tracce rilevate dall'apparato GPS, e la struttura di 
una classe wrapper che incapsula la logica di 
persistenza delle posizioni su di una base dati. 
In questa seconda parte, non ci resta che proget- 
tare e realizzare l'applicazione da installare nella 
nostra ipotetica Centrale di Controllo. 



LA CENTRALE 
DI CONTROLLO 

Tra le varie possibilità di implementazione, sce- 
gliamo una soluzione che soddisfa ai seguenti 
requisiti funzionali: 

• Innanzitutto vogliamo che la soluzione sia 
basata sul web; 



• In primo piano ci deve essere una mappa in 
cui vengono rappresentate le posizioni dei 
diversi dispositivi; 

• Le posizioni devono "fluire" sulla mappa, 
ovvero dobbiamo riprodurre sulla mappa i 
movimenti dei dispositivi, in tempo reale, 
quindi è auspicabile produrre una soluzione 
basata su AJAX (Asynchronous JavaScript and 
XML). 

Come primo problema dobbiamo trovare il 
modo di rappresentare su di una mappa le posi- 
zioni dei dispositivi. Negli ultimi tempi c'è stata 
una vera e propria "esplosione" di servizi orien- 
tati agli sviluppatori che consentono lo sviluppo 
di soluzioni di geolocalizzazione; tra le varie pos- 
sibilità, la nostra soluzione farà uso dei servizi 
messi a disposizione da due colossi del World 
Wide Web ovvero Google Maps, messo a disposi- 
zione da Google, e Virtual Earth, messo a dispo- 
sizione da Microsoft. 

Il lettore che volesse approfondire anche i servi- 
zi messi a disposizione da altri fornitori, può tro- 
vare, nel box laterale, le indicazioni per raggiun- 
gere le pagine dedicate agli sviluppatori da 
ViaMichelin e Yahoo. 

Le condizioni di uso dei vari servizi variano da 
caso a caso ma sono sempre chiare e dettagliate; 




— C#, Visual Studio 2005, 
LJ Javascript AJAX, SQL 
Server 2005 



H'ii\\ } cììM 



9 



Windows XP, Visual 
Studio 2005, Windows 
Mobile 5 SDK, SQL 
Server 2005 



^a^a^i 



Tempo di realizzazione 



Base Dati 
delle posizioni 




Fig. 1: Schema della soluzione 



Classe Wrapper 
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Gestione Mappe 



Pagina di Controllo 



LoadMap 



OnLoad 



Motore AJAX 



AddTre 



SendRequest 



CreateRequest 



Risorsa Asincrona 



Page_Load 



ManageResponse 



10 



AddTrack 



11! 



UpdatePage 



AJAXEQgimià 



8 



GetPo$ition$.a$px 



Classe Wrapper 



Virtù ùiEarth.js 



TrackGM.htm! 
TrackVE.htm 



• Oggetti 

• Rie 

• Metodi 



Fig. 2: Flusso delle operazioni nell'applicazione di controllo 



normalmente i servizi possono essere usati 
gratuitamente anche se, in questo caso, le 
condizioni di uso sono più restrittive. Di soli- 
to esiste altresì la possibilità di utilizzare in 
maniera commerciale il servizio; in questo 
caso però ogni fornitore ha le sue regole che 
possono variare notevolmente. 
Questa premessa solo per sottolineare che, 
nel caso in cui volessimo porre in produzione 
la nostra soluzione, dovremmo leggere atten- 
tamente le condizioni di uso del servizio che 
sceglieremo di utilizzare. 
Nell'esempio che stiamo analizzando, l'appli- 
cazione della nostra Centrale di Controllo svi- 
luppata con Google Maps è contenuta nel file 
TmckGM.html, quella sviluppata con Virtual 
Earth è contenuta nel file TrackVE.htm. 



GLI ELEMENTI 
DEL SISTEMA 

Anche se l'applicazione di controllo è rappresen- 
tata da un'unica pagina, la struttura "a strati" 
della soluzione e l'adozione di servizi esterni e 
tecnologie quali AJAX, fanno sì che l'analisi di 
tutti i componenti debba essere necessariamen- 
te preceduta da uno schema, che riassume sia gli 
elementi in gioco sia il flusso delle operazioni 
che avvengono quando accediamo alla pagina di 
controllo. 

Nella Figura 2 abbiamo rappresentato la 
sequenza di operazioni che vengono scatenate 



all'atto dell'apertura della pagina di controllo; i 
vari blocchi sono i metodi che vengono invocati 
in sequenza; abbiamo altresì raggruppato i 
diversi metodi in modo da poter individuare sia 
il componente logico che viene invocato, sia il 
relativo file in cui questi metodi sono memoriz- 
zati. 

Per meglio comprendere i vari elementi che ver- 
ranno descritti di seguito, è importante descrive- 
re la sequenza delle operazioni: 

1) La pagina di controllo viene caricata e viene 
scatenato l'evento OnLoad dell'elemento 
BODY che invoca il metodo LoadMap del 
componente di gestione della mappe il quale 
configura i parametri iniziali della mappa. 

2) Il metodo LoadMap crea un timer che ogni 3 
secondi invoca il metodo AddTracks che 
interroga, in modo asincrono, una risorsa 
remota che fornisce i dati dei diversi disposi- 
tivi. 

3) Il metodo AddTracks invoca il metodo 
SendRequest che rappresenta l'interfaccia "in 
ingresso" del motore AJAX che gestisce le 
richieste asincrone. 

4) Il metodo SendRequest invoca il metodo 
CreateRequest per la creazione di un oggetto 
di tipo XMLHttpRequest utilizzato per gestire 
le chiamate asincrone. 

5) Il metodo CreateRequest ritorna il giusto 
oggetto che dipende dal tipo di navigatore 
che stiamo usando dato che diversi navigato- 
ri supportano in modo diverso l'oggetto 



GetPositions 
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XMLHttpRequest. 

6) Il metodo SendRequest invoca la risorsa 
remota attraverso il metodo open dell'oggetto 
di tipo XMLHttpRequest. 

7) Nel nostro esempio, la risorsa remota è la 
pagina GetPositions.aspx di cui viene esegui- 
to il metodo Page_Load che crea una istanza 
della classe wrapper TrackerObject ed invoca 
il suo metodo GetPositions. 

8) Il metodo GetPositions ritorna una stringa che 
contiene i dati relativi ai dispositivi che 
vogliamo tracciare. 

9) La risorsa remota torna la risposta al chia- 
mante invocando il metodo ManageResponse 
del motore AJAX. 

10) Il metodo ManageResponse passa, a sua 
volta, il risultato proveniente dalla risorsa 
remota, al metodo UpdatePage della pagina 
di controllo. 

1 1) Il metodo UpdatePage invoca per ogni dispo- 
sitivo, il metodo AddTrack del componente di 
gestione delle mappe che, infine, disegna 
sulla mappa un indicatore che rappresenta la 
posizione del dispositivo. 

Per implementare il precedente meccanismo, a 
livello di codice, dobbiamo innanzitutto inserire 
nella pagina di controllo i riferimenti ad alcuni 
componenti utilizzati nello schema, ovvero il 
riferimento al servizio che intendiamo utilizzare, 
il riferimento al motore AJAX ed il riferimento al 
componente di gestione delle mappe. In testa 
alla pagina andremo allora a porre alcune 
dichiarazioni che fanno riferimento al relativo 
codice Javascript; per Microsoft Virtual Earth la 
dichiarazione è: 

<!— Riferimento al servizio Microsoft Virtual Earth — 

> 
<script 

src="http://dev.virtualearth.net/mapcontrol/mapcont 
rol.ashx?v=5"x/script> 
<!-- Riferimento al Motore AJAX — > 
<script src="AJAXEngine.js"></script> 
<!-- Riferimento al Gestore della mappa — > 
<script src="VirtualEarth.js"x/script> 

Per Google Maps invece: 



<!-- Riferimento al servizio Google Maps --> 
<script 
src="http://maps. google. com/maps?file=api&v 

=2&key=chiave" 
type="text/javascript"x/script> 
<!— Riferimento al Motore AJAX — > 
<script src="AJAXEngine.js"x/script> 
<!— Riferimento al Gestore della mappa — > 



<script src="GoogleMaps.js"x/script> 

Dobbiamo notare che per l'utilizzo dei servizi 
forniti da Google Maps è necessario richiedere 
una chiave di attivazione che poi dobbiamo spe- 
cificare proprio nella dichiarazione del relativo 
codice Javascript. Dato che questa chiave dipen- 
de dall'indirizzo in cui andremo a pubblicare la 
nostra applicazione, è prevedibile che, così 
come dichiarato nel file TrackGM.html, il codice 
non funzioni. Per utilizzare l'esempio fornito è 
necessario richiedere una propria chiave di atti- 
vazione e sostituirla con quella fornita; nel sito 
dedicato agli sviluppatori (il cui indirizzo è indi- 
cato nel box a lato) sono indicate tutte le proce- 
dure necessarie per ricevere le propria chiave di 
attivazione. 

Il corpo della pagina è molto semplice dato che 
tutte le interazioni, avvengono tramite un ele- 
mento di tipo div. Per Microsoft Virtual Earth il 
corpo della pagina è: 

<body onload = "LoadMap();"> 

<table width="10Q%"> 

<tr> 

<td colspan = "2" align = "left"xhl>Traccia la tua 

Flotta con Virtual Earth</hlx/td> 
<td align = "center" valign = "middle" rowspan = "2"> 
<div id='myMap' style="position:relative; 

width:600px; height:600px;" x/div> 

</td> 

</tr> 

<tr> 

<td align = "center" valign = "middle"ximg 

src="tracker.gif" /x/td> 

</tr> 

</table> 
</body> 
Per Google Maps invece: 



<body onload = "LoadMap()"> 



<table width="100%"> 



<tr> 



<td colspan = "2" align = "left"xhl>Traccia la tua 

Flotta con Google Maps</hlx/td> 
<td align = "center" valign = "middle" rowspan = "2"> 
<div id='map' style="position:relative; 

width:600px; height:600px;" x/div> 



</td> 



</tr> 



<tr> 



<td align = "center" valign = "middle"ximg 

src="tracker.gif" /x/td> 



</tr> 



</table> 



</body> 

Da notare la definizione del gestore LoadMap 
che, in occasione dell'evento di apertura della 
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pagina di controllo, scatena tutto il processo. 
Dato che abbiamo come riferimento lo schema 
dalla Figura 2, possiamo passare all'analisi dei 
singoli componenti che vengono interessati. 



IL MOTORE AJAX 

Il motore AJAX che utilizziamo nelle nostre pagi- 
ne è contenuto nel file AJAXEngine.js. 
Chiaramente la descrizione dei meccanismi che 
regolano le chiamate asincrone effettuate trami- 
te AJAX, esula dagli scopi del presente articolo. 
In questo contesto è interessante descrivere 
semplicemente come abbiamo implementato 
l'invocazione della risorsa remota e la relativa 
gestione della risposta. Alla base di tutto c'è l'og- 
getto XMLHttpRequest che ormai tutti i naviga- 
tori di ultima generazione supportano. Il nostro 
motore è composto da tre funzioni che rispetti- 
vamente creano l'oggetto XMLHttpRequest, 
inviano la richiesta asincrona e gestiscono la 
risposta. 

La funzione CreateRequest si occupa di creare un 
oggetto di tipo XMLHttpRequest. I diversi navi- 
gatori disponibili supportano l'oggetto 
XMLHttpRequest in modo differente. Alcuni 
hanno il supporto nativo, come, ad esempio, 
Mozilla Firefox. I navigatori di casa Microsoft 
invece supportano l'oggetto tramite la tecnolo- 
gia ActiveX con due diverse versioni dell'oggetto 
dipendenti dalla versione del navigatore. 
Dato che intendiamo sviluppare una applicazio- 
ne indipendente dal navigatore, la funzione 
CreateRequest gestisce le diverse situazioni resti- 
tuendo sempre il giusto oggetto. 

function CreateRequest() 

{ 

var request = false; 

try{ 

// Supporto Nativo 

request = new XMLHttpRequest(); 
} catch (newIE) { 

try { 

// Nuova versione di IE 



> 



return request; 



request = new 



ActiveXObject("Msxml2.XMLHTTP"); 



} catch (oldlE) { 



try{ 



// Vecchia versione di IE 



request = new 



ActiveXObject("Microsoft.XMLHTTP"); 



} catch (error) { 



// Il navigatore NON supporta XMLHttpRequest 



request = false; 



> 



} 



L'invio della richiesta è effettuata dalla funzione 
SendRequest che rappresenta l'interfaccia di 
ingresso del motore e che riceve in input l'indi- 
rizzo (compresi gli eventuali parametri) della 
risorsa da invocare. 

Nella prima linea di codice creiamo una istanza 
dell'oggetto XMLHttpRequest invocando la fun- 
zione CreateRequest appena analizzata. 
Dobbiamo quindi configurare la richiesta utiliz- 
zando il metodo open dell'oggetto 
XmlHttpRequest a cui passiamo, come primo 
parametro, il tipo di richiesta (che può essere 
"GET" o "POST"); come secondo parametro, 
l'indirizzo della risorsa web a cui connettersi; 
come terzo parametro un valore booleano che, 
se valorizzato a true, indica che la richiesta sarà 
asincrona. 

Nel caso in cui la risorsa a cui ci connettiamo 
necessiti di autenticazione, possiamo utilizzare 
la versione a 5 parametri del metodo open; 
potremo specificare un nome utente nel quarto 
parametro e la relativa password nel quinto 
parametro. 

Prima di inviare la richiesta al server dobbiamo 
ancora definire il meccanismo di "cali-back" in 
modo che il server sia in grado di ritornare le 
informazioni richieste, al navigatore. 
Per ora ci occupiamo di agganciare alla richiesta 
una funzione, che verrà invocata una volta che i 
dati saranno disponibili. Dobbiamo valorizzare 
la proprietà onreadystatechange dell'oggetto 
XmlHttpRequest che rappresenta il gestore del- 
l'evento associato alla variazione dello stato 
della richiesta; valorizziamo la proprietà con il 
nome della funzione che vogliamo utilizzare 
come gestore della risposta del server (analizze- 
remo la funzione a breve). 
Come ultima operazione dobbiamo inviare la 
richiesta al server; utilizziamo il metodo sena 
dell'oggetto XmlHttpRequest a cui si può passare 
come opzione un parametro per inviare conte- 
nuto al server. È possibile altresì inviare parame- 
tri sulla linea di comando, compilando opportu- 
namente l'URL della richiesta. 

function SendRequest(url) 

J 

// Creiamo l'oggetto XmlHttpRequest 

xmlHttpReq = CreateRequest(); 

// Configuriamo la richiesta 

xmlHttpReq.open("GET", uri, true); 

// Impostiamo la funzione di cali-back 

xmlHttpReq. onreadystatechange = ManageResponse 

// Inviamo la richiesta al server 




GOOGLE MAPS 

Per accedere al 
servizio messo a 
disposizione da 
Google puntiamo il 
nostro navigatore 
verso l'indirizzo: 
http://maps.google.com/ . 
L'area dedicata agli 
sviluppatori è 
raggiungibile a partire 
dall'indirizzo: 
http://www.google.eom/a 
pis/maps/ . 
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xmlHttpReq.send(null); 



ALTRI SERVIZI 
DI GEOLOCA- 
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La pagina dedicata 

agli sviluppatori del 

servizio ViaMichelin è 

raggiungibile 

all'indirizzo: 

http://dev.viamichelin. 

com/ . 

La pagina dedicata 

agli sviluppatori del 

servizio Yahoo Maps è 

raggiungibile 

all'indirizzo: 

http://developer.yahoo. 

com/maps/ . 



} 



Per gestire la risposta del server alla nostra 
richiesta, dobbiamo implementare la funzione 
ManageResponse che viene invocata ogni volta 
che varia lo stato della richiesta. 
Lo stato della richiesta può assumere valori che 
vanno da {uninitialized) a 4 [complete). 
Chiaramente l'elaborazione dei dati deve avve- 
nire solo dopo che la richiesta ha raggiunto lo 
stato "complete" . 

Prima di procedere nell'analisi della risposta, è 
necessario verificare che l'interazione non abbia 
generato errori. Attraverso le proprietà status e 
statusText possiamo verificare il codice di ritorno 
della richiesta HTTP. Il codice 200 (il cui relativo 
valore testuale è "OK") ci segnala che il colloquio 
non ha generato errori quindi possiamo elabora- 
re la risposta. 

In caso di errore lo stato verrà valorizzato con i 
valori che a volte riscontriamo durante la navi- 
gazione: 500 ("Internai Server Error"), 404 ("Not 
Found"), ecc. 

L'oggetto XmlHttpRequest mette a disposizione 
due proprietà attraverso cui possiamo elaborare 
la risposta del server: responseText contiene la 
risposta del server in formato stringa mentre 
responseXML contiene la risposta del server in 
formato XML, in particolare, se la risorsa invoca- 
ta è un web service, il documento XML ritornato, 
rappresenta il messaggio SOAP inviato dal ser- 
ver. 

Nell'esempio corrente la nostra funzione pas- 
serà semplicemente il contenuto della risposta 
ad una funzione (UpdatePage) che rappresenta 
l'interfaccia di uscita del motore e che dovrà 
essere implementata al livello della pagina che 
utilizza il motore AJAX. 

function ManageResponse() 

S 

// Verifichiamo che la richiesta sia completata 
if (xmlHttpReq.readyState == 4) 

_C 

// Verifichiamo che il colloquio non abbia generato 

errori 
if (xmlHttpReq.status == 200) 

_J 

// Passiamo la risposta del server ad una funzione 
// che gestirà il risultato al livello della pagina 
UpdatePage(xmlHttpReq. responseText); 
} 



} 



Strutturato in questo modo, il motore AJAX è un 
componente autocontenuto con una interfaccia 



di ingresso (SendRequest) ed una di uscita 
(UpdatePage); ciò ci consente di poterlo utilizza- 
re in ogni occasione in cui vogliamo aggiungere 
un supporto alle chiamate asincrone nelle 
nostre applicazioni. Ovviamente non pretendia- 
mo di sostituire i completi framework od oggi 
disponibili (uno su tutto ASP.NET AJAX), ma 
sicuramente, con poche linee di codice, siamo in 
grado di gestire "semplici" interazioni in modo 
rapido ed "economico". 



FACCIAMOLO 

COM GOOGLE MAPS 

Il tracciamento dei dispositivi avviene intera- 
gendo con le primitive messe a disposizione dai 
diversi servizi. Sebbene il risultato sia sostanzial- 
mente identico, i due servizi hanno sintassi 
diverse quindi è necessario analizzare separata- 
mente il codice Javascript relativo. 
Per interagire con Google Maps, nel file 
TrackGM.html poniamo un riferimento al file 
GoogleMaps.js che rappresenta il componente di 
gestione della mappa rappresentato in Figura 2. 
Il file contiene tre funzioni; la prima, LoadMap, 
viene invocata in fase di caricamento della pagi- 
na di controllo e non fa altro che creare un nuovo 
oggetto {map) che useremo per interagire con la 
mappa. Dopo aver aggiunto alcuni controlli e 
centrato la mappa (la posizione dell'esempio 
centra la mappa su Ancona), attiviamo un timer 
per effettuare l'aggiornamento delle posizioni. 
Il metodo Javascript setlnterval, viene utilizzato 
per invocare una funzione ogni volta che tra- 
scorre un intervallo di tempo espresso in millise- 
condi. In questo caso invochiamo, ogni 3 secon- 
di, la funzione AddTracks che non fa altro che 
invocare una risorsa remota attraverso la funzio- 
ne SendRequest del motore AJAX analizzato in 
precedenza. 

function LoadMap() 

i 

// Creiamo la mappa 
map = new 

GMap2(document.getElementById("map")); 
// Aggiungiamo alcuni controlli 
map.addControl(new GSmallMapControl()); 
map.addControl(new GMapTypeControl()); 
// Centriamo la mappa 
map.setCenter(new Gl_atl_ng(43. 6166483, 

13.5188783), 17); 

// Attiviamo il timer per l'aggiornamento 

timerld = setInterval("AddTracks()", 3000); 

_} 

function AddTracks() 

{ 
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Il Invoca la funzione del motore AJAX 
SendRequest('GetPositions.aspx'); 



L'ultima funzione del file GoogleMaps.js si occu- 
pa di porre sulla mappa un indicatore che rap- 
presenta un dispositivo da tracciare. La funzione 
AddTrack, viene invocata dalla funzione 
UpdatePage che rappresenta l'interfaccia di 
uscita del motore AJAX. La funzione riceve in 
ingresso quattro parametri: l'identificativo del 
dispositivo, la sua descrizione e le sue coordina- 
te geografiche rappresentate nella notazione 
decimale. Utilizzando le primitive del servizio, 
creiamo innanzitutto un oggetto che rappresen- 
ta il "punto geografico" corrispondente alle coor- 
dinate passate in ingresso. Quindi creiamo un 
oggetto "indicatore" (rappresentato da una 
icona) che verrà posizionato sulla mappa pro- 
prio nel punto creato alla linea precedente. Per 
aumentare l'esperienza del fruitore dell'applica- 
zione di controllo, associamo all'indicatore una 
funzione che gestisce l'evento del clic in modo 
che venga aperta una finestra informativa che, 
nella fattispecie, mostrerà l'identificativo e la 
descrizione del dispositivo rappresentato dal- 
l'indicatore. 

Come ultima operazione, aggiungiamo l'indica- 
tore alla mappa. 

function AddTrack(idDevice, deviceDescription, 

latitude, longitude) 

S 

// Creiamo un punto goegrafico 
var point = new Gl_atl_ng(latitude, longitude); 
// Associamo al punto un indicatore predefinito 
var marker = new GMarker(point); 
// Aggiungiamo all'indicatore l'evento "click" 
// per mostrare un messaggio informativo 
GEvent.addl_istener(marker, "click", 
function() { 

marker.openInfoWindowHtml("Dispositivo: " + 
idDevice + " <br/xb>" + 
deviceDescription + "</b>"); }); 
// Aggiungiamo l'indicatore alla mappa 
map.addOverlay(marker); 



avviene attraverso tre funzioni. La prima 
[LoadMap] si occupa di creare l'oggetto con cui 
andremo ad interagire (comprese le impostazio- 
ni iniziali ed il punto in cui viene centrata la 
mappa) e scatena il temporizzatore per l'aggior- 
namento delle tracce. La seconda funzione 
[AddTracks] non fa altro che invocare il motore 
AJAX con le identiche modalità dell'esempio 
visto in precedenza. L'ultima funzione 
[AddTrack) si occupa dell'effettiva creazione del- 
l'indicatore e del relativo posizionamento 

function LoadMap() 

i 

// Creiamo la mappa 



map = new VEMap('myMap'); 



// Centriamo la mappa 



map.LoadMap(new VEI_atl_ong(43.6166, 13.5189), 

17 ,'h' ,false); 

// Definiamo il tipo di mappa da visualizzare 

map.SetMapStyle(VEMapStyle.Road); 

// Nascondiamo alcuni controlli predefiniti 



map.HideDashboardO; 



// Attiviamo il timer per l'aggiornamento 
timerld = setInterval("AddTracks()", 3000); 



> 



function AddTracksQ 



{ 



// Invoca la funzione del motore AJAX 



SendRequest('GetPositions.aspx'); 



} 



function AddTrack(id Device, deviceDescription, 

latitude, longitude) 



{ 



// Creiamo un punto goegrafico 



var PPposition = new 



VEI_atl_ong(parseFloat(latitude), 
parseFloat(longitude)); 



// Associamo al punto un indicatore predefinito 
var shape = new VEShape(VEShapeType.Pushpin, 

PPposition); 
// Associamo all'indicatore le informazioni sul 

dispositivo 
shape. SetTitle('Dispositivo ' + idDevice); 
shape. SetDescription(deviceDescription); 



// Aggiungiamo l'indicatore alla mappa 
map.AddShape(shape); 
} 




MICROSOFT 

VIRTUAL 

EARTH 

Per accedere alle 
informazioni relative 
al servizio messo a 
disposizione da 
Microsoft puntiamo il 
nostro navigatore 
verso l'indirizzo: 
http://www.microsoft.co 
m/virtualearth/default.ms 
p_x da cui è accessibile 
il servizio vero e 
proprio di ricerca su 
mappa che è 
pubblicato all'indirizzo 
http://l oca I . I ive.com/. 
L'area dedicata agli 
sviluppatori è 
raggiungibile a partire 
dall'indirizzo: 
http://dev.live.com/virtual 
earth/ 



FACCIAMOLO CON 
VIRTUAL EARTH 

La pagina di controllo basata su Microsoft 
Virtual Earth è contenuta nel file TrackVE.htm 
mentre il relativo codice del componente di 
gestione della mappa del servizio è contenuto 
nel file VirtualEarth.js. 
Anche in questo caso, l'interazione con la mappa 



A causa della sostanziale corrispondenza delle 
funzioni svolte dal componente possiamo limi- 
tarci ad appuntare le differenze sintattiche tra i 
due servizi. 



LA RISORSA REMOTA 

Nel nostro esempio, la risorsa remota è rappre- 



si ttp: //www. io program mo.it 
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sentata dalla pagina GetPositions.aspx che ritor- 
na una stringa opportunamente formattata che 
contiene l'elenco delle informazioni afferenti ai 
dispositivi da tracciare. 

Se andiamo ad analizzare il codice "dietro" la 
pagina, notiamo che l'operazione svolta è bana- 
le a causa della stratificazione del codice che 
abbiamo imposto nello sviluppo della soluzione. 
All'atto del caricamento della pagina viene crea- 
ta una istanza della classe TrackerObject che 
abbiamo analizzato all'inizio dell'articolo. 
Quindi viene invocato il suo metodo 
GetPositions che restituisce la stringa di dati che 
non dobbiamo far altro che passare al chiaman- 
te tramite il metodo Write dell'oggetto Response. 
Prima di inviare la risposta al chiamante è 
opportuno impostare alcuni parametri al fine di 
evitare problemi con le cache dei navigatori. 



protected void Page_l_oad(object sender 



EventArgs e) 



// Creiamo una istanza della classe astratta 
TrackerObject. TrackerObject oTracker = new 

TrackerObject.TrackerObject(); 
// Ricaviamo le posizioni dei dispositivi 
string sPositions = oTracker.GetPositions(); 
// Configuriamo la cache 
Response. CacheControl = "no-cache"; 
Response. AddHeader("Pragma", "no-cache"); 
Response. Expires = -1; 
// Inviamo la risposta al chiamante 
Response. Write(sPositions); 
Response. End(); 



La pagina GetPositions.aspx termina il suo com- 
pito subito dopo aver inviato la risposta al chia- 
mante; come ultima riga di codice, invochiamo il 
metodo End dell'oggetto Response che invia al 
chiamante tutto il contenuto (eventuale) del 
buffer e termina l'esecuzione della pagina. 



LA FUNZIONE 
UPDATEPAGE 

La funzione UpdatePage, implementata a livello 
delle pagine di controllo, riceve in input il risul- 
tato dell'invocazione della risorsa asincrona; se 
facciamo un passo indietro e torniamo alla 
prima parte del presente articolo, ci ricordiamo 
che il risultato atteso è una stringa tipo: 



l^Primo 



Dispositivo / M3,61783 /v 13,52374|2 /v Secondo 
Dispositivo / M4,43323 A 13,44238| . . . 



Dopo aver eliminato tutte le tracce presenti sulla 
mappa, creiamo un array in cui ogni elemento 
rappresenta le informazioni relative ad un 
dispositivo; quindi scorriamo l'array e, dopo 
aver isolato ulteriormente le informazioni relati- 
ve al singolo dispositivo invochiamo la funzione 
AddTrack per posizionare la relativa traccia sulla 
mappa. 

Il servizio fornito da Google offre una interessan- 
te primitiva [getBounds) che ci consente di rica- 
vare i contorni visibili della mappa e verificare se 
un punto è contenuto nei suddetti contorni; di 
conseguenza riusciamo facilmente a capire se la 
traccia di un dispositivo esce dalla zona della 
mappa attualmente visibile e, di conseguenza, 
riusciamo a centrare nuovamente la mappa sul 
dispositivo in modo da "seguirlo" letteralmente. 
Nell'esempio oggetto dell'articolo si è scelto, a 
puro titolo di esempio, di "seguire" il primo 
dispositivo della serie. 

function UpdatePage(result) 

i 

// Eliminiamo tutte le tracce 



map.clearOverlaysO; 



// Creiamo un array in cui ogni elemento 
// rappresenta un dispositivo 



arrDevices = result.split('T'); 



for(var i=0; i<arrDevices.length-l; i++) 



{ 



// Creaimo un array in cui suddividiamo 

//le informazioni relative ad un singolo dispositivo 



arrPosition = arrDevices[i].split(" A "); 



// Se stiamo gestendo il primo dispositivo 



if(i == 0) 



{ 



// Ricaviamo i bordi della mappa 



var bounds = map.getBoundsQ; 



// Creiamo il punto in cui è I 
// localizzato il primo dispositivo 



var positionDevicel 



new GLatl_ng(arrPosition[2], 
arrPosition[3]) 



// Se il primo dispositivo è fuori dalla mappa 
if(! bounds. contains(positionDevicel)) 

J 

// Centriamo la mappa sul dispositivo 
map.setCenter(positionDevicel, 17); 
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// Aggiungiamo alla mappa l'indicatore del 
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dispositivo 



AddTrack(arrPosition[0], arrPosition[l], 

arrPosition[2], arrPosition[3]); 



} 



> 



TESTIAMO 
LA SOLUZIONE 

Siamo ormai giunti al termine, non dobbiamo 
far altro che distribuire i componenti della solu- 
zione e provare il tutto. 

Chiaramente la complessità della soluzione non 
consente una verifica rapida. Se non altro perché 
abbiamo bisogno di almeno due agenti: il con- 
trollore accede alla pagina di controllo e visualiz- 
za i movimenti del volontario che, armato di 
dispositivo mobile con antenna di ricezione 
satellitare e programma TackerMobile attivo e 
configurato, gira per la nostra città e si lascia 
tracciare. 

Ovviamente tutta la parte "web" della soluzione 
(pagina di controllo e web service) devono esse- 
re installate in un server "raggiungibile" dal 
dispositivo mobile ed in grado a sua volta di 
accedere alla rete in modo da raggiungere i ser- 
vizi di Google e Microsoft. 
Se supponiamo comunque di aver installato, 
configurato ed avviato correttamente tutti i 
componenti, se ci poniamo davanti alla pagina 
di controllo, vediamo qualcosa di simile alla 
pagina mostrata in Figura 3. 

L'icona di colore rosa rappresenta il dispositivo 
che stiamo tracciando. Con un gradevole effetto 
dinamico vediamo l'icona spostarsi sulla mappa 
in modo fluido (a causa di AJAX). Nella versione 
che utilizza il servizio Google Maps, se facciamo 
clic sull'icona, un fumetto ci fornisce alcune 
informazioni sul dispositivo. 



CONCLUSIONI 

Lo sviluppo tecnologico di dispositivi e sistemi 
software ormai ci consente di realizzare applica- 
zioni molto complesse con una relativa facilità. 
Nell'articolo appena letto abbiamo avuto modo 
di completare lo sviluppo di una soluzione com- 
pleta per il tracciamento di dispositivi in movi- 
mento sul territorio. 

Abbiamo ipotizzato una dotazione di dispositivi 
mobili basati sul sistema operativo Windows 
Mobile 5 o Windows Mobile 6, dotati di apparati 



per la ricezione satellitare (antenne GPS) e dota- 
ti di supporto telefonico per la comunicazione 
della posizione alla Centrale di Controllo. 
Nella prima parte dell'articolo abbiamo svilup- 
pato sia l'applicazione mobile sia il web service a 
cui, la suddetta applicazione, invia i dati relativi 
al posizionamento. Al fine di strutturare la solu- 
zione in più "strati logici", abbiamo altresì svi- 
luppato una classe wrapper che incapsula la 
logica di persistenza delle posizioni su di una 
base dati. 

In questa seconda parte abbiamo sviluppato 
l'applicazione di controllo che è basata su servi- 
zi di geolocalizzazione forniti da Google o 
Microsoft e sfrutta la potenzialità di AJAX per 
gestire il movimento delle tracce. 
Se vogliamo ipotizzare qualche utilizzo della 
nostra soluzione, possiamo pensare, ad esem- 
pio, alla sala operativa della Polizia Municipale 
della nostra città dove, in un maxischermo, ven- 
gono visualizzate le posizioni delle pattuglie 
distribuite sul territorio in modo da poter dirige- 
re l'unità più vicina in caso di sinistro. 
Un altro utilizzo "civico" lo possiamo ipotizzare 
per una azienda di trasporto pubblico locale 
dove, a fronte della posizione corrente degli 
autobus, si possono dare informazioni ai passeg- 
geri in attesa alle fermate, sui tempi di attesa del 
proprio mezzo. 

Anche le aziende di trasporto merci, piuttosto 
che i pony-express possono trarre giovamento 
dal sapere in tempo reale la posizione dei diver- 
si corrieri per soddisfare in modo più rapido le 
continue richieste dei clienti. 
Da questi pochi esempi possiamo già capire che, 
ancora una volta, il limite all'utilizzo di queste 
tecnologie avanzate è la nostra fantasia. 

Oscar Peli 




Traccia la tua Flotta 
con Google Maps 





Fig. 3: La pagina di controllo (versione Google Maps) 
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TRACCE ISO DAI 
NOSTRI PROGRAMMI 

PERCHÈ UTILIZZARE UN SOFTWARE ESTERNO PER MASTERIZZARE I DATI? CREIAMO 
UN'APPLICAZIONE IN GRADO DI GESTIRE LE TRACCE ISO. USIAMOLE COME SE FOSSERO 
UNA PARTE DEL NOSTRO FILE SYSTEM, IN MODO DEL TUTTO TRASPARENTE 



^ 







empre più spesso si rende necessario dover la- 
vorare con delle immagini di CD, DVD, Filesy- 
' stem o altro. L'utilità di avere queste immagini 
che "rispecchiano" il contenuto di tali dispositivi di me- 
moria di massa è quella di riuscire ad effettuare dei back- 
up completi e salvarli su un file, astraendo quindi il con- 
tenitore dei dati dal vero e proprio mezzo fisico, per 
poi ridistribuirlo e ripristinarlo nelle maniere che più 
si ritengono opportune. 

Esiste una serie molto vasta di programmi che per- 
mettono di generare un'immagine a seconda del tar- 
get e viceversa, cioè generare un CD o un DVD a par- 
tire da un file immagine (operazione che viene co- 
munemente detta di masterizzazione). Nero è sicu- 
ramente il più famoso e conosciuto tra tutti questi 
software ma non è il solo. 



siamo testare solamente dopo che l'immagine è sta- 
ta masterizzata. Sarebbe invece di grande utilità po- 
ter "ingannare" il nostro computer in modo tale da ma- 
sterizzare l'immagine in questione non su un DVD 
o CD, bensì su una porzione del nostro hard- disk che 
venga però riconosciuta dal sistema operativo come 
un'unità fisica.. 




Figura 1: montaggio di un'unità virtuale con etichetta X. 



jn 
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UHI ESEMPIO PRATICO 

Uno degli innumerevoli scenari possibili potrebbe 
essere questo: 

supponiamo di dilettarci per hobby di video proces- 
sing e che solitamente i nostri amici ci chiedano di 
abbellire i lori filmati con sottotitoli, effetti etc I no- 
stri amici potrebbero fornirci l'immagine del loro 
DVD (magari mettendolo su un nostro server ftp) in 
modo da poterlo masterizzare su un nostro DVD ver- 
gine. Al termine delle modifiche creeremo una nuo- 
va immagine che conterrà il filmato ritoccato da re- 
stituire al nostro amico. 

Tale situazione è nella pratica molto inefficiente e 
costosa, infatti ogni volta siamo costretti a masteriz- 
zare un DVD per poi buttarlo appena terminato il la- 
voro. Così facendo sprechiamo sia del tempo, poi- 
ché dobbiamo aspettare di portare a termine la ma- 
sterizzazione di un DVD, sia un DVD vergine per ogni 
lavoro, poiché una volta terminato il lavoro, del DVD 
masterizzato non sappiamo più che farcene. 
Uno scenario molto simile a quello precedentemente 
descritto lo abbiamo incontrato un po' tutti quando 
scarichiamo un'immagine da un programma P2P. 
Infatti molte volte non possiamo avere la certezza 
del contenuto di ciò che abbiamo scaricato e lo pos- 



PIANIFICAZIONE 
DELL'APPLICAZIONE 

Cominciamo con il fissare una serie di punti guida 
che ci serviranno per sviluppare la nostra applica- 
zione. Per poter realizzare quanto sopra detto avre- 
mo bisogno di: 

1 - montare e smontare delle unità senza in alcun 
modo andare a modificare le tabelle di partizione del 
nostro hard disk. 

2 - leggere un'immagine (ISO, BIN-CUE etc.) ed 
estrarre il suo contenuto sull'unità virtuale. 

3 - navigare l'unità virtuale creata come qualsiasi al- 
tra unità "reale". 



CREARE TANTE UNITA 
SENZA CREARE NESSUNA 
PARTIZIONE 

Il primo ostacolo da superare è quella di creare o ri- 
cavare un'unità aggiuntiva che fungerà da "DVD vir- 
tuale". Una prima idea potrebbe essere quella di par- 
tizionare nuovamente il nostro hard disk in modo ta- 
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le da ritagliare un po' di spazio (pari almeno a quel- 
lo di un DVD) per la nostra unità aggiuntiva e dedicare 
quest'ultima solamente allo scopo di unità "fantoc- 
cio" che emuli un DVD. Questo tipo di approccio pre- 
senta almeno due aspetti macroscopicamente ne- 
gativi che ci spingono alla ricerca di una possibile so- 
luzione più efficiente: 

1 - le operazioni di partizionamento sono sempre 
considerate altamente rischiose; basterebbe questo 
a farci desistere dal nostro intento. 

2 - sarebbe uno spreco riservare spazio ad un'unità 
che in realtà utilizzeremo una volta ogni tanto e di 
cui una volta finite tali operazioni non sapremmo 
più che farcene. 



Nulla è stato ancora modificato sulla tabella delle 
partizioni, per cui se riawiate il sistema operativo 
non troverete più l'unità fittizia. Per rendere perma- 
nente una configurazione così creata è possibile scri- 
vere un file batch contenente le istruzioni desidera- 
te e linkarlo sotto "esecuzione automatica", ma ciò 
esula dagli scopi di quest'articolo. 
Analogamente se volessimo rimuovere tale unità 
(senza dover riawiare il sistema operativo) basterà 
eseguire il comando: 

subst/DX: 

E' superfluo ribadire che, anche in questo caso, la 
scomparsa dell'unità non implica la scomparsa dei 
dati che invece rimarranno intatti sotto la directory 




-0- 



Fortunatamente esiste un comando dos che si chia- 
ma subst che ci permette proprio di mappare un'u- 
nità virtuale su una directory. Per un momento quin- 
di svestiamo i panni di programmatori e diamo un'oc- 
chiata ai vecchi comandi dos invocabili dal prompt. 
La sintassi del comando subst è la seguente: 

1 - per montare una nuova unità: 
SUBST [unità:] [percorso] 

2 - per smontare un'unità virtuale precedentemen- 
te creata: 

SUBST /D [unita':] 

Per comprendere meglio di cosa si tratta facciamo 
qualche esempio. Naturalmente trattandosi di un 
comando DOS avrete bisogno di lanciare la shell, op- 
pure digitare direttamente il comando cliccando su 
Start, poi su Esegui. 

Dobbiamo innanzitutto scegliere una cartella che 
verrà considerata come cartella "radice" dell'unità 
virtuale, ad esempio sotto C: io ho creato una direc- 
tory chiamata Unit_X. A questo punto se volessimo 
creare un'unità con label X: basterà digitare: 

subst X: C:\Unit_X 

Naturalmente è necessario che l'unità X non esista 
già, altrimenti il comando fallirà. Se ora andate su 
"Risorse del computer" e, se tutto è andato a buon 
fine, avrete una nuova unità X. 
Questa "partizione fittizia" avrà le dimensioni del- 
l'hard disk della partizione contenente la cartella ori- 
ginaria (nel nostro caso C:\Unit_X) . Ovviamente se 
occupate spazio su e: \ , lo occuperete anche su x: e vi- 
ceversa (nonostante non aggiungiate nulla nella car- 
tella C:\Unit_X) visto che comunque al livello prati- 
co i cluster occupati sono sempre gli stessi; di con- 
seguenza se si formatta la partizione originaria scom- 
pare anche l'unità virtuale. In figura 1 trovate un 
esempio di quanto detto. 



C:\Unit_X 



ESEGUIRE I PROGRAMMI 
COME THREAD 



Ora che siamo venuti a conoscenza dell'esistenza di 
un comando DOS che fa al caso nostro sarà neces- 
sario integrarlo all'interno della nostra applicazio- 
ne. 

Quest'ultima verrà implementata in C#, per cui, più 
in generale, sarà necessario lanciare un processo na- 
tivo (cioè del sistema operativo) all'interno di un pro- 
cesso .NET. A questo proposito esiste già una classe 
.NET che permette di avere un buon controllo sui 
processi esterni. Con "buon controllo" intendo che, 
tra le altre cose, si possono eseguire le seguenti ope- 
razioni: 

• lanciare un processo esterno (comando, applica- 
zione etc.) come se fosse un thread parallelo 

• "attaccarsi" al processo in modo tale da bloccare l'e- 
secuzione del codice seguente finché il processo 
stesso non termina 

• ridirigere lo standard output, input ed error all'in- 
terno dell'applicazione stessa, così che sia possibile 
"catturare" tutti i messaggi che il processo esterno 
invia (sull'output e/o sulT error) o inviarne noi sul- 
l'input. 

• Verificare l'exit code del processo stesso in modo ta- 
le da poterne verificare se quest'ultimo ha termi- 
nato il proprio compito con successo oppure no. 

La classe in questione si chiama propria Process e si 
trova all'interno del namespace System. Diagnostics. 
Nel corso di quest'articolo parleremo diffusamente 
di questa classe. Cominciamo però con il dare un'oc- 
chiata alla figura 2 che illustra come si presenterà la 
GUI dell'applicazione che stiamo sviluppando. 
Come potete notare sulla sinistra è stato posto un 
controllo grafico (vedi nota) che ricorda l'approccio 
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SE AL POSTO 

DI WINDOWS 

C'È LINUX 

L'applicazione è stata 

sviluppata per un 

ambiente Windows, 

infatti con Linux le 

cose sarebbero un po' 

più immediate. Ciò 

deriva dal fatto che 

per quest'ultimo tutto 

è un file, quindi anche 

un'immagine può 

essere montata e 

smontata come fosse 

un'unita, basta 

specificare il tipo di 

filesystem in 

questione. Ad esempio 

per un'immagine ISO 

9660 basterà il 

comando: 

mount myiso.iso 

Itnntlisol -t ÌSO9660 
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Figura 2: Interfaccia grafica dell'applicazione Image 
Viewer. 



user- friendly del resource explorer di Windows, a de- 
stra invece sono stati piazzati tre bottoni: 

1. monta unità virtuale 

2. smonta unità virtuale 

3. estrai immagine 

Veniamo quindi al codice sottostante il primo bot- 
tone: 

private void buttonMount_Click(object sender, 

EventArgs e) 

{ 

if (textBoxLabel.Text == string.Empty) 

{ 

MessageBox.Show(this, "you have to 

enter a label for the virtual unit", "error", 
MessageBoxButtons.OK, MessageBoxIcon. Error); 
return; 

} 

if (folderBrowserDialogl.ShowDialog(this) ! = 

DialogResult.OK) 

return; 



Process subst = new Processo ; 
subst.Startlnfo.FileName = "subst"; 
subst. Startlnfo.Arguments = 

textBoxLabel.Text + ": " + 
folderBrowserDialogl.SelectedPath; 

subst.StartQ; 

subst.WaitForExitQ; 



if (subst. ExitCode != 0) 

MessageBox.Show(this, "I cannot create 
this unit", "errori", MessageBoxButtons.OK, 
MessageBoxIcon. Error); 
fileSystemListViewl.RefreshView(); 
} 



La prima cosa che facciamo è controllare se l'utente 
abbia effettivamente specificato una lettera per iden- 
tificare l'unità virtuale che vuole creare, se così non 
fosse un messaggio d'errore verrà visualizzato ed il 
codice successivo non sarà eseguito. 

if (textBoxLabel.Text == string.Empty) 
{ 



MessageBox.Show(this, "you have to 

enter a label for the virtual unit", "error", 
MessageBoxButtons.OK, MessageBoxIcon. Error); 
return; 
} 

Naturalmente il controllo TextBox ha impostata co- 
me lunghezza massima del testo un solo carattere. 
Se invece il test precedente viene superato si chiede 
all'utente su quale directory vuole che l'unità virtuale 
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Figura 3: Selezione della cartella dove verrà montata l'u- 
nità virtuale. 



venga montata come mostrato in figura 3. 
A questo punto viene poi creata un'istanza della clas- 
se Process, e valorizzati opportunatamente alcuni 
campi in modo tale che sia in grado di eseguire cor- 
rettamente il comando subst 

Process subst = new Processo ; 
subst.Startlnfo.FileName = "subst"; 
subst. Startlnfo.Arguments = 

textBoxLabel.Text + ": " + 
folderBrowserDialogl.SelectedPath; 

il primo campo rappresenta semplicemente il nome 
del comando da eseguire, il secondo invece indica 
gli argomenti da passare al comando stesso. Come 
già illustrato, il comando subst per montare un'unità 
virtuale ne richiede l'etichetta e la directory di root- 
point. Una volta impostato bene l'oggetto è possibi- 
le invocare il metodo start per lanciare il comando. È 
importante notare che una volta invocato tale me- 
todo si passa immediatamente all'istruzione suc- 
cessiva senza che il processo sia effettivamente ter- 
minato. Affinché ciò avvenga è quindi necessario in- 
vocare il metodo WaitForExit che attende il comple- 
tamento del processo stesso. 

subst. Start(); 
subst.WaitForExitQ; 



* 58 /Ottobre 2007 



http://www.ioprogrammo.it 



056-061:072-080 31-08-2007 16:13 Pagina 59 



Gestire le tracce ISO ■ T SISTEMA 



Una volta terminato, tramite l'exit code, verifichia- 
mo se il processo è andato a buon fine, in caso con- 
trario lo segnaleremo con un messaggio d'errore. In- 
fine aggiorneremo il controllo che visualizza le ri- 
sorse del computer. 

if (subst.ExitCode != 0) 

MessageBox.Show(this, "I cannot create 
this unit", "errori", MessageBoxButtons.OK, 
MessageBoxIcon.Error); 
fileSystemListViewl.RefreshView(); 



regex = new 
System.Text.RegularExpressions.Regex(".*\\(([A- 

Z]:)\\)"); 

string text = 

fileSystemListViewl.SelectedItems[0].Text; 
if (! regex. IsMatch(text)) 

throw new Exception("you must select a 

unit"); 
return regex. Match(text).Groups[l].Value; 




-0- 



Il codice sottostante il secondo bottone, quello che ser- 
ve per smontare l'unità virtuale, è concettualmente 
del tutto analogo a quello che si occupa del montag- 
gio; naturalmente la stringa per valorizzare gli argo- 
menti di start sarà diversa poiché in questo caso con- 
terrà l'opzione /D 

private void buttonl_Click(object sender, EventArgse) 

{ 

//"Locai Disk(X:)" 

try 



string unit = getVirtualUnit(); 



Process umount = new Process(); 



umount.Startlnfo.FileName = "subst"; 
umount. Startlnfo.Arguments = "/D " +unit; 



umount. Sta rt(); 



umount. WaitForExitQ; 



fileSysteml_istViewl.RefreshView(); 



} 



catch (Exception ex) 



{ 



MessageBox.Show(this, ex.Message, 

"error", MessageBoxButtons.OK, 
MessageBoxIcon.Error); 



Un'altra variazione nella logica di questa operazione 
sta nella selezione dell'unità virtuale da smontare. 
Infatti è necessario che l'utente selezioni (dal con- 
trollo posto a sinistra) un'unità e non una directory 
o file qualsiasi; per questo è stato previsto il metodo 
getVirtualUnitO che si occupa proprio di accertarsi che 
sia stata effettivamente selezionata un'unità ed in 
caso affermativo ne restituisce l'etichetta. 
Per adempiere a questo compito getVirtualUnitO fa 
uso di un'espressione regolare in modo tale da isolare 
solamente la lettera che indica l'etichetta dell'unità. 
Visto che non rientra negli scopi di questo articolo 
illustrare le regular expression mi limiterò esclusiva- 
mente a riportare il codice: 

private string getVirtualUnitO 

{ 

System.Text.RegularExpressions. Regex 



UN'IMMAGINE ISO 

Una volta che siamo riusciti a montare e smontare 
un'unità virtuale non ci rimane altro che trovare un 
modo per estrarre un'immagine. Esistono vari for- 
mati di immagini, in quest'articolo focalizzeremo la 
nostra attenzione sul formato stabilito dall'organiz- 
zazione internazionale degli standard (ISO). Con- 
cettualmente però vedremo in seguito che se usassimo 
un altro tipo di formato non cambierà pressoché nul- 
la ai fini della nostra applicazione. Giusto per avere un'i- 
dea di come sia definito tale standard spendiamo 
qualche frase per descrivere cosa sia un'immagine 
ISO 9660. Trattandosi appunto di uno standard, la 
seguente definizione è tratta da wikipedia: 
ISO 9660 è il nome del file system standard per i CD- 
ROM, per i sistemi operativi DOS/Windows, Macin- 
tosh e Unix. Sviluppato nel 1987 dall' International 
Organizationfor Standardization. Le specifiche de- 
finiscono il formato della directory per un CD-ROM 
e un CD-R e prevedono tre livelli. 

Il Livello 1 limita rigidamente la lunghezza dei nomi 
di file e cartelle al formato 8.3 del Dos (8 caratteri per 
il nome, 3 per l'eventuale estensione), con set di ca- 
ratteri maiuscoli, numeri e underscore, nidificazio- 
ne delle cartelle fino all'ottavo livello, con un massi- 
mo di 255 caratteri per percorso. I file devono essere 
scritti in settori contigui. 

Il Livello 2 estende a 32 caratteri la lunghezza massi- 
ma dei nomi di file e cartelle, ferme restando le re- 
strizioni in termini di livello di nidificazione, lun- 
ghezza del percorso e scrittura in settori contigui. 

Il Livello 3 abilita la scrittura di file in settori non con- 
tigui del supporto 

L'esperienza fatta con il comando subst può tornar- 
ci utile anche in questo caso. Infatti se invece di un co- 
mando del nostro sistema operativo avessimo un fi- 
le eseguibile da linea di comando che provvedesse 
all'estrazione dell'immagine il gioco sarebbe fatto. 
Come avrete sicuramente già intuito un programma 
che fa al caso nostro esiste e si chiama MagicISO, che 



http://www.ioprogrammo.it 



Ottobre 2007/ 59 ► 



056-061:072-080 31-08-2007 16:13 Pagina 60 



SISTEMA T ■ Gestire le tracce ISO 




■€+ 



Il controllo per 

l'esplorazione delle 

risorse del computer è 

reperibile all'indirizzo 

http://www.codeproject.c 

om/cs/miscctrl/FileSystemL 

istView.asp ed è 

facilmente integrabile 

con Visual Studio 

2005. 



nella sua versione limitata, è scaricabile dal sito 
http://www.magiciso.com/download.htm . In particola- 
re a noi non interessa l'applicazione nella sua inter- 
faccia grafica, bensì due file che troverete nella di- 
rectory d'installazione del programma: miso.exe e 
misoh.dll. Il primo è infatti proprio l'eseguibile in- 
vocando il quale potremmo estrarre l'immagine, 
mentre il secondo è una libreria necessaria all'ese- 
guibile stesso. La prima cosa da fare è quindi copia- 
re entrambi i file sul percorso di output del nostro 
progetto (per intenderci la directory bin dove viene crea- 
to l'exe della nostra applicazione), in modo tale che 
sappiamo che miso.exe sia sempre nella stessa di- 
rectory della nostra applicazione. Va notato che la 
versione non registrata non può lavorare con imma- 
gini di dimensioni superiori ai 300MB. 



URI WRAPPER 
PER URI PROCESSO 

Estrarre un'immagine è sicuramente una procedura 
un po' più delicata di quanto non lo sia l'invocazio- 
ne del comando subst visto precedentemente. Per 
questo motivo abbiamo deciso di creare una classe ap- 
posita che "incapsuli" il processo d'estrazione; per 
tale motivo la classe prende il nome di ExtractProcess. 
È sembrato opportuno concepire tale classe come 
un singleton, in modo tale che esista una ed una so- 
la istanza che possa effettuare l'estrazione dell'im- 
magine, quindi: 

class ExtractProcess 

{ 

private static ExtractProcess instance = nuli; 



process.Startlnfo.RedirectStandardOutput = 



public static ExtractProcess getlnstanceQ 



{ 



if (instance == nuli) 



instance = new ExtractProcessQ; 



return instance; 



} 



Il costruttore sarà perciò privato e inizializzerà l'og- 
getto globale Process in questo modo: 

private ExtractProcess() 

{ 

Filelnfo app = new 
FileInfo(System. Windows. Forms. Application. Executabl 

ePath); 

string extractFileName = 
System.IO.Path.Combine(app.DirectoryName, 

"miso.exe"); 
process = new Processo ; 
process. Startlnfo.FileName =extractFilel\lame; 
process. Startlnfo.RedirectStandardError =true; 



true; 



process. Startlnfo.UseShellExecute = false; 
process. OutputDataReceived += new 

DataReceivedEventHandler(OutputHandler); 
process. ErrorDataReceived +=new 

DataReceivedEventHandler(ErrorHandler); 
} 

La prima parte del codice è sostanzialmente analo- 
ga a quella vista in precedenza per il comando sub- 
st. La parte nuova è quella successiva, ossia: 

process. Startlnfo.RedirectStandardError =true; 



process. Startlnfo.RedirectStandardOutput = 



true; 



process. Startlnfo.UseShellExecute = false; 
process. OutputDataReceived += new 

DataReceivedEventHandler(OutputHandler); 
process. ErrorDataReceived +=new 

DataReceivedEventHandler(ErrorHandler); 

con queste righe reindirizziamo lo stream di output 
ed error verso la nostra classe, in particolare la "cat- 
tura" dei dati dai due stream è delegata rispettiva- 
mente ai metodi: OutputHandler e ErrorHandler. 
Tali dati sono memorizzati in uno StringBuilder: 

class ExtractProcess 
{ 



private StringBuilder outputBuffer, errorBuffer; 



private void OutputHandler(object sendingProcess, 

DataReceivedEventArgs outLine) 



{ 



outputBuffer.AppendLine(outLine.Data); 



} 
e poi esposta all'esterno come property read-only: 

public string OutputMessage 

{ 

get 

{ 

if (outputBuffer != nuli) 

return outputBuffer. ToString(); 
else 

return string. Empty; 

} 

} 
public int extract(string imageFile,string outputDir) 

{ 

outputBuffer = new StringBuilder(); 
errorBuffer = new StringBuilder(); 
Filelnfo image = new Filelnfo(imageFile); 
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if (Mmage.Exists) 



throw new FileNotFoundException("file 

not found: " + imageFile, imageFile); 
Directorylnfo output = new 

Directorylnfo(outputDir); 



output. CreateQ; 



string previousCurrentPath = 

System. Environment.CurrentDirectory; 
System. Environment.CurrentDirectory = 

outputDir; 



try 



{ 



process.Startlnfo.Arguments 

="\""+imageFile+"\" "+ "-x " +outputDir; 



process.Start(); 



process.BeginErrorReadLine(); 



process.BeginOutputReadl_ine(); 



process.WaitForExit(); 



return process.ExitCode; 



} 



catch (Exception e) 



{ 



throw e; 



finally 



System. Environment.CurrentDirectory = 

previousCurrentPath ; 



process.CancelErrorReadQ; 



process.CancelOutputReadQ; 



} 



In primo luogo verifichiamo che il file dell'immagi- 
ne esista veramente, altrimenti lanciamo un'ecce- 
zione. Dopo di che valorizziamo gli argomenti del 
processo e lo lanciamo; subito dopo cominciamo a leg- 
gere lo standard output e quello error in modo che i 
metodi delegati precedentemente definiti possano 
catturarne le notifìche. Infine aspettiamo che il pro- 
cesso d'estrazione venga portato a termine. 
Per tornare alla nostra GUI quindi il codice sotto- 
stante al terzo bottone, quello con l'etichetta "Estrai 
Immagine", sarà: 

private void button2_Click(object sender, EventArgs e) 

{ 

if (openFileDialogl.ShowDialog(this) ! = 

DialogResult.OK) 
return; 



ExtractProcess p 



ExtractProcess.getlnstanceQ; 



try 



string unit = getVirtualUnit(); 



p.extract(openFileDialogl.FileName,unit); 
MessageBox.Show(this, "Immage 
extracted sucessfully into " + unit + " unit", 



string. Empty, MessageBoxButtons.OK, 
MessageBoxIcon. Information); 



} 



catch (Exception ex) 



{ 



MessageBox.Show(this, ex.Message, 

"error", MessageBoxButtons.OK, 
MessageBoxIcon . Error) ; 



} 



I tre passi che l'utente deve compiere sono riportate 
in figura 4-5-6. 
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Figura 4: Selezione dell'immagine che verrà estratta. 
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Figura 5: Estrazione dell'immagine sull'unità virtuale 
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Figura 6: Esplorazione dell'unità virtuale per verificare 
che l'immagine sia stata estratta correttamente. 



CONCLUSIONI 

In questo articolo abbiamo sviluppato un'applica- 
zione che può risultare nella pratica spesso utile in 
diverse occasioni. Inoltre è stata colta l'occasione per 
capire come all'interno del framework .NET si possa 
avere il controllo di processi esterni ad esso. 
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DAI UNA CACHE 
AL TUO SOFTWARE 

LE APPLICAZIONI NON SONO MAI ABBASTANZA VELOCI. LE TECNICHE DI CACHING SONO UNO 
DEI METODI PRINCIPALI PER AUMENTARNE LE PERFORMANCE. IMPARIAMO AD UTILIZZARE IL 
CACHING APPLICATION BLOCK CON MICROSOFT VISUAL STUDIO 
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Tempo di realizzazione 



Qualsiasi tipo di applicazione realizziamo 
per lavoro o per diletto, necessiterà prima 
o poi in alcune sue parti di utilizzare qual- 
nica per ottimizzare la gestione dei dati e 
ridurre il tempo di attesa dell'utente durante ela- 
borazioni o query particolarmente complesse. Per 
quanto riguarda le applicazioni Web il .NET Fra- 
mework ci viene abbondantemente in aiuto for- 
nendoci diverse possibilità per implementare tec- 
niche di caching. Il namespace System. Web. Cache 
ci fornisce infatti tutte le classi necessarie per uti- 
lizzare la cache nelle nostre applicazioni Web e nei 
Web Services. 

La cache di ASP.NET però, sebbene possa essere 
utilizzata anche in applicazioni non Web, fornisce 
il meglio di se solo in questo ambiente ma soprat- 
tutto non essendo stata progettata specificamen- 
te per lavorare fuori da questo ambiente, non è 
supportata da Microsoft se utilizzata in applica- 
zioni non Web. Per fornire uno strumento più ge- 
nerico, completo ed utilizzabile in qualsiasi tipo 
di applicazione, Microsoft ha quindi sviluppato il 
Caching Application Block (CAB), ovvero una so- 
luzione di caching totalmente gratuita e robusta 
inclusa nel più ampio pacchetto di soluzioni de- 
nominato Enterprise Library, giunto al momento in 
cui scriviamo alla versione 3. 1 di Maggio 2007. 
Prima del rilascio di questa libreria e del Caching Ap- 
plication Block, gli sviluppatori dovevano creare di 
proprio pugno i metodi per la gestione della cache 
con il rischio di introdurre nuovi colli di bottiglia o 
nuovi bug e con tutte le complicazioni che una im- 
plementazione del genere comporta. Con il Caching 
Application Block è possibile gestire la cache in qual- 
siasi livello della nostra applicazione, quindi nello 
strato dati, nello strato business od anche nello stra- 
to di presentazione (considerando la classica archi- 
tettura a tre livelli) . Vediamo quindi di applicare pra- 
ticamente questa libreria andando a sviluppare una 
semplice applicazione demo che faccia uso del CAB 
nella lettura di file di testo e nel recupero di dati da da- 
tabase. Vedremo la notevole differenza che ci sarà 
quando utilizzeremo o meno la cache per recupera- 
re i dati o per leggere i file. 



INSTALLAZIONE 

Innanzi tutto recuperiamo la Enterprise Library ef- 
fettuando il download dal sito Microsoft ed instal- 
liamola sulla nostra macchina. Il processo di in- 
stallazione non richiede particolari accorgimenti, 
è sufficiente infatti specificare solo il percorso di 
installazione degli assembly della libreria e suc- 
cessivamente il percorso dei sorgenti e dei progetti 
Quick Start. L'ultimo passo del processo di instal- 
lazione consiste nella compilazione di tutti i sorgenti 
e richiederà alcuni secondi durante i quali sarà vi- 
sualizzata una finestra che mostrerà i nomi dei fi- 
le sorgente mentre vengono compilati. Se non si 
sono modificati i percorsi di installazione, gli as- 
sembly che dovremo referenziare nel nostro progetto 
saranno presenti nel percorso: 

<disco>:\Program Files\Microsoft Enterprise Library 

3.1 - May 2007\Bin 




Figura 1: Diagramma delle dipendenze di Caching 
Application Block 
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In particolare, tra i diversi assembly dell'intera En- 
terprise Library, per utilizzare le funzionalità di ba- 
se del Caching Application Block, dovremo refe- 
renziare nel nostro progetto solo: Microsoft. Prac- 
tices.EnterpriseLibrary. Common.dll e Microsoft.Prac- 
tices.EnterpriseLibrary. Caching. dll. 
Di default il Caching Application Block usa come re- 
pository della cache la memoria di sistema ma è 
possibile anche scegliere di utilizzare un database 
SQL Server impostando opportunamente alcuni 
parametri. Per utilizzare un database SQL però è 
necessario referenziare anche gli assembly del Da- 
ta Access Application Block. E se dovessimo avere la 
necessità di criptare i dati della cache per questio- 
ni di sicurezza in particolari applicazioni in cui la 
riservatezza dei dati è importante, è possibile an- 
che utilizzare la criptazione / decriptazione dei da- 
ti tramite l'uso del Cryptography Application Block. 



IMPLEMENTAZIONE 

Avviamo Visual Studio e creiamo un nuovo pro- 
getto Windows Application da File -> New Project. . . , 
scegliamo quindi il template Windows Applica- 
tion, assicuriamoci che come Language ci sia Vi- 
sual C# e premiamo OK. Come prima operazione, 
referenziamo i due assembly necessari all'utilizzo 
del Caching Application Block, ovvero Mi- 
crosoft. Practices.EnterpriseLibrary. Common.dll e 
Microsoft. Practices.EnterpriseLibrary. Caching. dll 
dalla cartella <disco>:\Program Files\Microsoft En- 
terprise Library 3.1 - May2007\Bin. Aggiungiamo an- 
che un file di configurazione nel quale dovremo 
inserire alcune voci relative alla configurazione del 
nostro application block. Clicchiamo quindi con 
il tasto destro del mouse sul progetto, scegliamo 
Add -> Newltem..., selezioniamo il tipo di file Ap- 
plication Configuration File e quindi premiamo 
Add. 

A questo punto nel file App.config appena aggiun- 
to copiamo le seguenti chiavi di configurazione al- 
l'interno del nodo configuration: 

<configSections> 

<section name="cachingConfiguration" 
type="Microsoft. Practices.EnterpriseLibrary. 
Caching. Configuration. CacheManagerSettings, 
Microsoft. Practices.EnterpriseLibrary. Caching" /> 
</configSections> 
<cachingConfiguration 

defaultCacheManager="Default Cache Manager"> 
<backingStores> 
<add name="inMemory" 
type="Microsoft. Practices.EnterpriseLibrary. 
Caching. BackingStorelmplementations. 

NullBackingStore, 
Microsoft. Practices.EnterpriseLibrary. Caching" /> 



</backingStores> 



<cacheManagers> 



<add na me = "Default Cache Manager" 
expirationPollFrequencyInSeconds="60" 

maximumElementsInCacheBeforeScavenging = "1000" 
numberToRemoveWhenScavenging="10" 
backingStoreName="inMemory" /> 
</cacheManagers> 

</cachingConfiguration> 



Con queste chiavi di configurazione abbiamo de- 
finito una sezione di configurazione per il CAB nel- 
la quale abbiamo specificato una serie di parame- 
tri tra i quali il backingStoreName ovvero il nome del- 
la chiave che definisce il repository della nostra ca- 
che. Il backing store specificato [inMemory] fa ri- 
ferimento al namespace: 

Microsoft. Practices.EnterpriseLibrary. Caching. Backing 

Storelmplementations 

e nello specifico alla classe NullBackingStore ov- 
vero all'implementazione della cache in memo- 
ria. Le altre implementazioni specificabili sono: 

• IsolatedStorageBackingStore 

Gli item sono immagazzinati nello Storage speci- 
fico dell'application domain, ovvero una partico- 
lare cartella del disco riservata all'applicazione 

• DataBackingStore 

Utilizza un database come backing store dei da- 
ti ed utilizza a sua volta il Data Access Applica- 
tion Block 

L'implementazione NullBackingStore a cui fare- 
mo riferimento in questo articolo è l'implemen- 
tazione in memoria della cache e per tale motivo è 
una implementazione che non persiste gli item. 
Questo significa che per esempio a differenza del- 
l'implementazione DataBackingStore, una volta 
terminata l'applicazione, gli item in cache saran- 
no eliminati. L'applicazione è composta da tre 
Windows Form. Un form è utilizzato come entry 
point dell'applicazione e visualizza due tasti at- 
traverso i quali è possibile scegliere la demo da av- 
viare, mentre gli altri due form contengono ri- 
spettivamente la demo relativa alla lettura di file 
di testo e quella relativa alla lettura di dati dal da- 
tabase. Per la demo facente uso del database uti- 
lizziamo il ben noto database No rthwind fornito- 
ci dalla Microsoft proprio per l'utilizzo in applica- 
zioni di prova. Il form frmFileViewer ci mostra co- 
me il caricamento di un file di testo di ragguarde- 
voli dimensioni può essere accelerato tramite l'u- 
tilizzo della cache mentre il form frmTableViewer 
dimostrerà quanto le performance di un'applica- 
zione facente uso di database possano essere mi- 
gliorate tramite l'utilizzo di CAB. 




DOVE 
TROVARE 
LA LIBRERIA 
ENTERPRISE 
LIBRARY 3.1 
MAY 2007 
La Enterprise Library 
3.1 May 2007 è dispo- 
nibile al seguente 
indirizzo: 

http://www.microsoft.co 
m/down loads/details.aspx 
?FamilvlD=4c557c63- 
708f-4280-8f0c- 
637481c31718&display - 
lang=en 
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GLI ALTRI 

APPLICATION 

BLOCK DELLA 

ENTERPRISE 

LIBRARY 

La Enterprise Library 

oltre al Caching 

Application Block, 

contiene anche altri 

utili application block: 

Cryptography 

Application Block, 

Data Access 

Application Block, 

Exception Handling 

Application Block, 

Logging Application 

Block, Policy Injection 

Application Block, 

Security Application 

Block e Validation 

Application Block 



UTILIZZO DELLA CACHE 
NELLA LETTURA DI FILE 

Come abbiamo detto poco sopra, partiamo innanzi 
tutto con lo specificare due using che ci permet- 
teranno di utilizzare agevolmente i namespace del 
CAB: 

using Microsoft. Practices.EnterpriseLibrary. Common; 
using Microsoft. Practices.EnterpriseLibrary. Caching; 

dopo di che creiamo nel costruttore del form una 
istanza di classe del CacheManager, ovvero l'og- 
getto principale attraverso il quale potremo utiliz- 
zare la cache messa a disposizione dal Caching Ap- 
plication Block: 

private CacheManager _manager; 

public frnriFileViewer() 

i 

InitializeComponent(); 

// Creo l'oggetto CacheManager per la gestione 

della Cache 
_manager = CacheFactory.GetCacheManager(); 
} 

Il metodo GetCacheManager restituisce il cache 
manager di default definito nel file di configura- 
zione (nel nostro caso "Default Cache Managef) ma 
se avessimo diversi cache manager potremmo spe- 
cificarne il nome passando quest'ultimo come pa- 
rametro: 

_manager = CacheFactory.GetCacheManager("Other 

Cache Manager"); 

A questo punto vediamo il metodo che salva le ri- 
ghe del file selezionato nella cache: 

private void StoreFileInCache(string fileName) 

i 

if (!_manager.Contains(txtFilel\lame.Text)) 

{ 

int lineNumber = 0; 
string[] fileContent = 

File.ReadAIILines(txtFileName.Text); 
string[] cachedContent = new 

string [fileContent. Length]; 



foreach (string line in fileContent) 

{ 

linel\lumber+ + ; 

cachedContent[linel\lumber-l] = 
lineNumber. ToString().Padl_eft(10, '0') + " " + line; 
} 



cachedContent); 



} 



Qui verifichiamo che nella cache sia presente un 
item avente come chiave il nome del file stesso (ma 
potevamo utilizzare una qualsiasi altra chiave di 
tipo string) e se non presente recuperiamo dal file 
selezionato tutte le righe attraverso il metodo sta- 
tico ReadAllLines della classe File e poi dopo aver 
aggiunto ad ogni riga del file il numero di riga in- 
seriamo l'array di string così ottenuto nella cache 
dandogli come chiave il nome stesso del file. 
Ora vediamo i due metodi che caricano il file in 
una ListBox, l'uno ricaricando nuovamente il file da 
disco, l'altro recuperando il file dalla cache. Qui il 
vantaggio nell'uso della cache sarà apprezzabile 
solo con file di dimensioni elevate in quanto in 
realtà la lettura da disco utilizza già un buffer di 
lettura che mette in cache alcune porzioni dei file. 
Ma soprattutto l'uso della cache è indicato nel mo- 
mento in cui i dati (in questo caso le righe del file) 
sono oggetto di elaborazioni anche pesanti che ri- 
chiedono quindi molto tempo di CPU e che gra- 
zie all'uso della cache possono essere eseguite una 
volta sola anziché ad ogni lettura del file. Un altro 
scenario in cui il CAB è molto indicato è la richie- 
sta di dati da Web Service i quali possono implica- 
re tempi di accesso considerevoli che la cache per- 
mette di ridurre notevolmente. 

private cmdl_oadWithoutCache_Click(sender, e) 

_C 

if (txtFileName.Text != "") 

{ 

IbFileContent.Items.ClearO; 

int lineNumber = 0; 

int startTime = .TickCount; 



string[] fileContent = 

.ReadAIILines(txtFileName.Text); 

foreach (line fileContent) 

_i 

NneNumber++; 



lbFileContent.Items.Add( 
lineNumber. ToString().Padl_eft(10, '0') 



"+ line); 



} 



txtLoadingtime.Text = 

Convert.ToString(. TickCount - startTime); 



_manager.Add(txtFileName.Text, 



} 



Con il gestore dell'evento click del tasto cmd- 
LoadWithoutCache leggiamo nuovamente le righe 
dal file selezionato, aggiungiamo i numeri di riga e 
ripopoliamo la ListBox con le righe del file. Quin- 
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di senza utilizzare la cache. 

private void cmdLoadWithCache_Click(object sender, 

EventArgs e) 

_C 

if (txtFileName.Text != "") 



{ 



if (_manager.Contains(txtFileName.Text)) 



{ 



IbFileContent.Items.ClearO; 



int startTime = Environment.TickCount; 
string[] rows = 

(string[])_manager[txtFileName.Text]; 



foreach (string row in rows) 



{ 



lbFileContent.Items.Add( row); 



} 



txtLoadingtime.Text = 

Convert.ToString(Environment.TickCount - 

startTime); 



} 



> 



Con questo metodo invece recuperiamo le righe 
del file dalla cache e le visualizziamo nella List- 
Box senza rileggerle dal disco e senza dover ag- 
giungere nuovamente i numeri di riga. 
In entrambi i casi, grazie all'utilizzo della pro- 
prietà Environment.TickCount che tiene conto 
dei millisecondi trascorsi dall'avvio del sistema, 
abbiamo calcolato il tempo dell'operazione svol- 
ta visualizzandolo in un'apposita casella di te- 
sto. 

Ecco quindi i tempi di lettura visualizzati nel- 
l'applicazione con l'utilizzo della cache: 



Log file narne C:\WINC 















Load Without Cache 


Loading Time (ms.) 
|U53 


Load Frorm Cache 













File content 
0000000001 
0000000002 
0000000003 
0000000004 
0000000005 
000000000G 
0000000007 
0000000008 
0000000009 
0000000010 
0000000011 
0000000012 
0000000013 



^Software: Microsoft Internet riformatori Services 5.1 

tìVersion: 1.0 

tìDate: 2007-05-04 08:42:20 

ttFields: tirine c-ip cs-rnethod cs-uri-stenn se-status 
42:20 127.0.0.1 GET /05/Default.aspx 200 
42:20127.0.0.1 GET /05/style2.css 304 

08:42:20127.0.0.1 GET /05/images/ns-titgif 304 

" "42:20 1 27.1 spacer.gif 304 

42:20127.0.0.1 GET /05/images/btn-ok.gif 304 
42:20127.0.0.1C- :-s/logo1b.gif 304 

42:20127.1 n0.gif 304 

08:42:20127.0.0.1 GET /05/imaqes/m1b.qif 304 

08:42:20127.0.0.1 GET, 2b.gif 304 



>: 



l CL05E | 



Figura 2: Lettura file di testo dalla cache 

e senza l'utilizzo della cache, ovvero leggendo il fi- 
le direttamente da disco: 



Log file narne C: \WI N D WS \sjistem32\Logf iles\W3S VC1 \ex070504. log | Load... | 

Loading Time (ms.) 



; oadWithoul Uache 



Load From L 



File content 



0000000001 «Software: Microsoft Internet Information Services 5.1 

0000000002 «Versioni 1.0 

0000000003 SD 04 00:42:20 

0000000004 ttFields: (ime e ip cs-rnethod cs-uri-stern se-status 

0000000005 08:42:20 127 0.0 1 ;ì t; : /05/D efault, asp:-; 200 

0000000006 08:42:20127.0.0.1 GET '05.'.ivle2 e. 304 

0000000007 08:42:20 127.0.0 I GET /05/imaaes/ris-tiLail 304 

0000000008 08 42:20 127 0.0 1 GÈ r /05/iniaqes/spacer.a I 304 
0000000003 08:42:20 127 0.0.1 6E r /05/miaqes/btn ok.qif 304 

0000000010 08 42 20 127 1 GET /05/irnaqes/loqolb. qif 304 

000000001 1 08:42 20 127 0.0.1 GÈ : /05/irr.aqes/rnO qif 304 

0000000012 08:42:20 127 l] ; 6E : /05/ir.iaqes/rnl b aif 304 
000000001:3 08:42:20 127 0.0 I GEI /05/imaaes/rn2b aif 304 



K 



| CLOSE 



Figura 3: Lettura file di testo da disco 

Come possiamo notare la differenza, seppur mi- 
nima in questa demo, è comunque rilevabile. 



UTILIZZO DELLA CACHE 
NELLA LETTURA DI DATI 
DA DATABASE 

Passiamo quindi al secondo form, quello facente uso 
del database. In questo form abbiamo una Grid- 
View che visualizzerà il contenuto della tabella Or- 
der_Details del database Northwind. Anche in que- 
sto caso abbiamo un metodo che salva i dati in ca- 
che dopo averli letti dal database: 

private StoreDataInCache() 

i 

this.order_DetailsTableAdapter.Fill(_northwindDataSet 

.Order_Details); 
_manager.Add("OrderDetails", 

_northwindDataSet.Order_Details); 
} 

Qui però in cache salviamo una intera DataTable 
riempita con i dati del database Northwind ed in par- 
ticolare della tabella Order_Details, che utilizzia- 
mo in quanto contenente un numero rilevante di 
record che fanno al caso nostro. Il metodo Store- 
DatalnCache viene richiamato per comodità in fa- 
se di Load del form. Così come nell'esempio pre- 
cedente abbiamo qui due metodi per il carica- 
mento dei dati, uno che utilizza la cache ed un al- 
tro che invece non ne fa uso: 

private void cmdLoadWithoutCache_Click(object 

sender, EventArgs e) 

i 

int startTime = Environment.TickCount; 

this.order_DetailsTableAdapter.Fill(_northwindDataSet 

.Order_Details); 

BindGridView(_northwindDataSet.Order_Details); 
txtLoadingtime.Text = 




^^B 



DLL MEI PRO- 
GETTI 

In Visual Studio per 
referenziare un assem- 
bly in un progetto è 
sufficiente cliccare con 
il tasto destro del 
mouse sul nome del 
progetto, scegliere la 
voce Add Reference... , 
cliccare sul tab Browse 
e selezionare dal disco 
rigido la DLL che s'in- 
tende referenziare nel 
progetto. 
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Convert.ToString(Environment.TickCount - 

startTime); 



} 



Con questo metodoeffettuiamo la Fili della DataT- 
ableOrderJDetailse quindi la mettiamo in binding 
con la GridView per mostrarne il contenuto. 

private cmdLoadWithCache_Click(sender, e) 

_C 

int startTime = .TickCount; 
BindGridView((NorthwindDataSet._DetailsDataTable)_ 
manager["OrderDetails"]); 
txtLoadingtime.Text = 

Convert.ToString(. TickCount - startTime); 
} 

In questo metodo invece mettiamo in binding la 
GridView direttamente con la DataTable contenu- 
ta nella cache e riempita in precedenza tramite il me- 
todo StoreDatalnCache. 

private void BindGridView( 

NorthwindDataSet.Order_DetailsDataTable dt) 

{ 

// Inserisce un valore casuale nella colonna 

UnitPrice della prima riga 
// per rendere visibile l'aggiornamento della 

GridView 
Random rnd = new Random(); 
dt[0]. UnitPrice = (decimal)md.Next(); 

gvOrderDetails.DataSource = dt; 
} 

Infine troviamo il metodo BindGridView nel qua- 
le mettiamo la GridView in binding con la DataTa- 
ble ed inseriamo nella colonna UnitPrice della pri- 
ma riga un valore casuale al solo scopo di render- 
ci visibile l'aggiornamento della GridView ad ogni 
pressione dei due tasti di caricamento. 
In questo secondo esempio la differenza di pre- 
stazioni sarà più evidente rispetto all'esempio con 
i file di testo in quanto è sicuramente molto più 
oneroso per la macchina caricare una intera ta- 



COSA SONO GLI APPLICATION BLOCK 



IL DATABASE 
NORTHWIND 

Il database Northwind 
è il tipico database di 
test pensato dalla 
Microsoft per essere 
utilizzato nelle appli- 
cazioni demo. E 1 
disponibile un pac- 
chetto d'installazione 
contenente il database 
Northwind e il databa- 
se Pubs (altro db di 
demo) al seguente 
indirizzo: 
http://www.microsoft.co 
m/down loads/details.aspx 
?FamilvlD=06616212- 
0356-46A0-8DA2- 
EEBC53A68034&display - 
lang=en 



Gli application block di cui in 
questo articolo utilizzeremo 
quello dedicato alla gestione 
del caching, sono componenti 
riutilizzabili ed estendibili (in 
quanto è a disposizione anche il 
codice sorgente) che forniscono 
una guida per la soluzione dei 
più comuni problemi di 



programmazione. La Enterprise 
Library è una libreria che 
raccoglie tutti gli application 
block aggiungendovi inoltre 
documentazione ed esempi di 
utilizzo utili per famigliarizzare 
con ogni application block ed 
imparare velocemente ad 
utilizzarli. 



bella contenente centinaia di record dal database 
piuttosto che dalla memoria attraverso la cache. 
Vediamo allora i tempi di lettura visualizzati nel- 
l'applicazione con l'utilizzo della cache: 
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Figura 4: Lettura dati dalla cache 

e senza l'utilizzo della cache, ovvero leggendo i da- 
ti dal database: 



Load Without Uache 



Loading Time (ms.) 



I oad i rom Uache 
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CLOSE 



Figura 5: Lettura dati direttamente dal database 



L'OGGETTO 
CACHEMANAGER 

Dopo aver visto questo esempio pratico di utilizzo 
della cache del CAB passiamo quindi ad analizzare l'og- 
getto CacheManager, fulcro e cuore dell'intero ap- 
plication block. Questa classe non è una classe mol- 
to complessa, infatti contiene (nell'implementazio- 
ne NullBackingStore) solo sei metodi significativi e 
tutti molto semplici da usare. La sua potenza infatti 
sta proprio in questo. Il CAB nasconde allo svilup- 
patore la complessa logica di gestione del caching 
fornendo metodi semplici ed auto esplicativi. Ecco un 
elenco riassuntivo dei metodi e della loro funzione: 

• Add 

Aggiunge un nuovo item alla cache. Se in cache 
esiste già un item con la stessa chiave di quello che 
si sta inserendo, l'item esistente viene rimosso e 
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sostituito con il nuovo. 

• Contains 

Data la chiave di un itera indica se questo è già pre- 
sente o meno in cache 

• Count 

Restituisce il numero totale di item della cache 

• Flush 

Rimuove tutti gli item dalla cache 

• GetData 

Ritoma uno specifico item data la sua chiave. Gli item 
vengono sempre restituiti di tipo object. Deve quin- 
di essere effettuato un cast al tipo corretto dell'i- 
tera. Un item può essere inoltre recuperato anche 
direttamente senza l'utilizzo di GetData attraver- 
so il metodo implicito Item. Es. object item - _man- 
ager ["chiave"]; 

• Remove 

Rimuove uno specifico item data la sua chiave 

Vediamo in particolare il metodo Add che fornisce 
due overload. Il metodo Add come abbiamo detto 
permette l'inserimento di un item in cache e nella 
sua versione più semplificata accetta come parame- 
tri semplicemente la chiave dell'itera e l'item stesso 
sotto forma di object. Il metodo Add accetta però, ol- 
tre alla chiave e all' item, anche altri parametri nel 
suo secondo overload: 

• scavengingPriority 

Specifica la priorità dell'itera ael momeato in cui 
la cache viene liberata. Questo parametro è di tipo 
CacheltemPriority e può assumere i valori: High, 
Low, None, Normal, NotRemovable. Il valore di de- 
fault (se non specificato) è Normal. 

• refreshAction 

Questo parametro di tipo ICacheltemRefreshAc- 
tion, specifica una classe che viene richiamata ogni 
qual volta un item scade e permette di intrapren- 
dere una qualsiasi azione per aggiornare l'item pri- 
ma che questo scada. 

• espirations 

Questi parametri permettono di specificare una 
serie di classi derivanti da ICacheltemExpiration 
implementanti delle regole che definiscono come 
e quando un item può scadere. Di default, se non 
specificato diversamente, gli item non scadono. 

Le classi che implementano ICacheltemRefreshAc- 
tion e ICacheltemExpiration devono essere serializ- 
zabili. 



ENTERPRISE LIBRARY 
COIMFIGURATIOIM 

All'inizio di questo articolo abbiamo creato un file di 
configurazione in cui abbiamo inserito una serie di 
chiavi necessarie per definire il comportamento del 



CAB. Queste stesse chiavi possono essere gestite in una 
maniera più amichevole attraverso l'applicazione 
Enterprise Library Configuration che possiamo trovare, 
dopo aver installato correttamente la Enterprise Library, 
nel menu: 

Start -> Ali programs -> Microsoft patterns & prac- 
tices -> Enterprise Library 3. 1 - May 2007 -> Enter- 
prise Library Configuration 




Figura 6: Enterprise Library Configuration 

Attraverso questa comoda interfaccia potremo con- 
figurare tutti gli application block delia Enterprise Li- 
brary, tra cui quindi anche il Caching Application 
Block, semplicemente aprendo il file App.confg del no- 
stro progetto demo dal menu Elle -> Open Application 
e modificando opportunamente i parametri di con- 
figurazione. 



CONCLUSIONI 

Il caching è uno degli aspetti fondamentali dello svi- 
luppo software ed una implementazione solida di 
queste tecniche nelle nostre applicazioni può esse- 
re spesso determinante nella riuscita delle stesse. La 
gestione della cache dei dati è un problema molto 
noto agli sviluppatori web che difatti utilizzano pra- 
ticamente sempre tecniche simili per velocizzare le 
proprie web application. Ma anche nello sviluppo 
desktop si deve avere particolare attenzione verso i tem- 
pi di risposta degli applicativi perché se è vero che i 
computer attuali sono sempre più potenti è anche 
vero che le applicazioni attuali devono gestire moli di 
dati sempre maggiori ed una corretta gestione dei 
tempi di risposta è necessaria se non fondamenta- 
le per garantire una buona usabilità da parte dell'u- 
tente. Come abbiamo visto l'utilizzo del Caching Ap- 
plication Block è abbastanza semplice e quindi è no- 
stro compito solo individuare i punti giusti dove uti- 
lizzare la cache per rendere sempre più performan- 
ti le aostre applicazioai. 

Gianni Malanga 
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XPS: L'ALTERNATIVA 
MICROSOFT AL PDF 

OLTRE ALLE MIGLIAIA DI FUNZIONALITÀ RIVOLTE ALL'ASPETTO GRAFICO, WINDOWS 
PRESENTATION FOUNDATION, CI METTE A DISPOSIZIONE UNA SERIE DI SERVIZI RIVOLTI 
ALLA GESTIONE DEI DOCUMENTI. INTEGRIAMO IL NUOVO XPS NEL NOSTRO SOFTWARE 
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REQUISITI 



i ii ii h'i ^m 

r "7 Conoscenze minime del 
*SJ .NETframework2.0, 
conoscenze di base di 
Windows Presentation 
Foundation, conoscenze 
dei concetti di base dei 
linguaggi di markup 



i Visual Studio 2005 o 
superiore; .NET 3 
Runtime; Visual Studio 
Extensions for 
Windows Presentation 
Foundation 
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00000 



"ella maggior parte delle demo viste su 
Windows Presentation Foundation as- 
sistiamo a veri e propri spettacoli sce- 
nografici con interfacce molto accattivanti ed 
innovative. Effettivamente la potenzialità prin- 
cipale di Windows Presentation Foundation è 
proprio quella di mettere a disposizione classi 
per semplificare la creazione di interfacce sem- 
pre più vicine a quello che ormai l'utente fina- 
le si sta abituando con la diffusione del web. 
Tuttavia, Windows Presentation Foundation, 
mette a disposizione avanzate funzionalità per 
semplificare la creazione di contenuti rivolti al- 
la lettura introducendo, quindi, nuove funzio- 
nalità per la gestione documentale attraverso 
classi utili alla formattazione, impaginazione e 
per la creazione di pacchetti nel nuovo forma- 
to XML Paper Speci fication (XPS) sviluppato da 
Microsoft come alternativa al già conosciuto 
PDF creato da Adobe. 

Diamo, innanzitutto, uno sguardo alla gestio- 
ne dei documenti in Windows Presentation 
Foundation. 



DOCUMENTI CON WPF 

Come già accennato, Windows Presentation 
Foundation, mette a disposizione avanzate fun- 
zionalità per semplificare la creazione di contenuti 
rivolti alla lettura, quindi documenti. In gene- 
rale, quando abbiamo bisogno di visualizzare 
del testo come semplici etichette o titoli nelle 
nostre Window, utilizziamo Label o il nuovo 
controllo TextBlock ma, in casi di veri e propri do- 
cumenti utilizzeremo le classi messe a disposi- 
zione ad Windows Presentation Foundation. 
Abbiamo, innanzitutto, due categorie di docu- 
menti a disposizione denominati "FixedDocu- 
ment" e "Flow Document". Come è già facil- 
mente intuibile dai nomi, i FixedDocument so- 
no documenti con una struttura fissa a pre- 
scindere, quindi, dal tipo di supporto di visua- 
lizzazione che può essere un monitor piuttosto 



che una stampante. Con la classe FlowDocu- 
ment, invece, possiamo definire dei documen- 
ti caratterizzati dal fatto che questi si adattano 
in maniera ottimale al supporto in cui vengo- 
no visualizzati. 



UN FLOW-DOCUMENT 
PER UN ARTICOLO 
DI GIORNALE 

L'utilizzo di un documento di tipo FlowDocu- 
ment può essere utilizzo per creare delle pagine 
di un giornale che può essere visualizzato a vi- 
deo o stampato e non ha bisogno di una strut- 
tura fissa come lo dovrebbe essere, ad esempio, 
per una fattura, ma deve adattarsi al device su 
cui viene visualizzato per dare una maggiore co- 
modità nella lettura all'utente. 
Un banale esempio di definizione di un Flow- 
Document è il seguente. 

<FlowDocument 

xmlns="http://schemas. microsoft.com/winfx/2006/xaml 

/presentation" 
ColumnWidth = "200" FontSize="16" 

FontFamily="Georgia" 
> 
<Paragraph FontSize="22" FontWeight="Bold"> 

DOCUMENTI IN WPF 
</Paragraph> 
<Paragraph> 

Nella maggior parte delle demo viste su Windows 
Presentation Foundation assistiamo a veri e propri 

[■■■] 

</Paragraph> 
<Paragraph> 

Tuttavia, Windows Presentation Foundation, mette a 
disposizione avanzate funzionalità per semplificare la 

[■■■] 

</Paragraph> 
<Paragraph 
Diamo, innanzitutto, uno sguardo alla gestione dei 
documenti in Windows Presentation Foundation. 
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</Paragraph> 


<Paragraph> 


Come già accennato, 


Windows Presentation 


Foundation, 


mette a 


disposizione 


avanzate 
[■■■] 




</Paragraph> 


</FlowDocument> 



Questo è un semplice documento che, come ve- 
dete, utilizza come elemento root un FlowDo- 
cument mentre, all'interno troviamo diversi pa- 
ragrafi definiti attraverso l'elemento Paragraph. 
In Fig.l vediamo il nostro documento visualizzato 
all'interno dell'apposito Viewer messo a dispo- 
sizione dal framework con le classiche funzio- 
nalità di zooming, navigazione tra pagine, ecce- 
tera. 

In questo caso il Viewer viene visualizzato auto- 
maticamente visto che la Window di avvio del 
progetto è proprio un FlowDocument. Infatti non 
è possibile utilizzare un FlowDocument diretta- 
mente all'interno di una normale o meglio è pos- 
sibile ma non direttamente. Un FlowDocument 
infatti non viene renderizzato in una Window 
ma è necessario utilizzare un FlowDocumen- 
tReader che contenga il FlowDocument da vi- 
sualizzare. 

< Window x:Class="FlowSample.Windowl" 
xmlns="http://schemas. microsoft.com/winfx/2006/xaml 

/presentation" 
xmlns:x="http://schemas. microsoft.com/winfx/2006/xa 

mi" 

Title="FlowSample" Height="300" Width = "300" 
> 

<Grid> 
< FlowDocumentReader> 



<FlowDocument> 



<!— Definizione del documento — > 



</FlowDocument> 



</FlowDocumentReader> 



</Grid> 



</Window> 

Altra caratteristica del documento appena crea- 
to è il fatto che, ridimensionando la Window, i 
paragrafi vengono sempre adattati alle nuove di- 
mensioni visto che questo è stato definito, ap- 
punto, come FlowDocument. Purtroppo l'im- 
magine statica dell'articolo non rende bene l'idea 
e per questo vi consiglio di provare l'esempio voi 
stessi. 

Nell'esempio, inoltre, vengono utilizzati gli oggetti 
Paragraph che in Windows Presentation Foun- 
dation fanno parte dei cosiddetti Blocks ossia 
degli oggetti che vengono utilizzati per definire 
dei gruppi di testo e che, internamente, sono 



classi che derivano dalla classe System. Win- 
dows. Documents. Block. 

Windows Presentation Foundation mette a di- 
sposizione cinque tipi di Blocks: 

• Paragraph - contiene una collection di Inlines 
che sono il contenuto del paragrafo. Da codi- 
ce XAML è possibile indicare semplicemente la 
stringa di testo oppure utilizzando gli oggetti 
Run che aggiungono alla collection di Inlines 
un elemento. 

• Section - utile per raggruppare delle sezioni 
che devono avere le stesse caratteristiche. 

• List- genera un elenco numerato, puntato o 
cumunque una semplice lista. Tra le varie pos- 
sibilità offerte c'è quella di personalizzare l'a- 
spetto dei puntatori. 

• Table - permette l'organizzazione dei conte- 
nuti in righe e colonne. 

• BlockUIContainer- può contenere alcuni controlli 
WPF come Button, Image, contenuti 3D o Me- 
diaElement. 

Tornando all'esempio precedente è possibile, quin- 
di, utilizzando un BlockUIContainer inserire delle 
immagini. 

<FlowDocument 

xmlns="http://schemas. microsoft.com/winfx/2006/xaml 

/presentation" 
ColumnWidth = "200" FontSize="16" 

FontFamily="Georgia" 
> 
<Paragraph FontSize="22" FontWeight="Bold"> 

DOCUMENTI IN WPF 
</Paragraph 
<BlockUIContainer> 

<Image Source="NETFw.jpg"/> 
</BlockUIContainer 
< Paragraph > 

Nella maggior parte delle demo viste su Windows 
Presentation Foundation assistiamo a veri e propri 
spettacoli scenografici con interfacce molto 
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Figura 1: II nostro articolo visualizzato con WPF 
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</Paragraph> 



<Paragraph> 



-0- 



Tuttavia, Windows Presentation Foundation, mette a 
disposizione avanzate funzionalità per semplificare la 

[■■■] 



</Paragraph> 



<Paragraph> 



Diamo, innanzitutto, uno sguardo alla gestione dei 
documenti in Windows Presentation Foundation. 



[- 



</Paragraph> 



<Paragraph> 



Come già accennato, Windows Presentation 
Foundation, mette a disposizione avanzate 

[■■■] 



</Paragraph> 



</FlowDocument> 

Abbiamo accennato, a proposito del Block Para- 
graph, alla collection di elementi Inlines che pos- 
sono essere inseriti in un, appunto, Paragraph 
per far si che il suo contenuto sia più interes- 
sante di un semplice testo piatto. Per aggiunge- 
re elementi alla collection Inlines, occorre uti- 
lizzare la proprietà Run che aggiunge, quindi, 
una stringa di testo al paragrafo. 

< Paragraph > 

<Run>Prova di aggiunta elemento Inlines</Run> 
<Run>Secondo elemento Inlines</Run> 
</Paragraph> 

E' possibile, per ogni Run, specificare caratteristiche 
diverse come ad esempio il Font, il colore, lo stile. 

< Paragraph > 

<Run FontSize="20">Prova di aggiunta elemento 

Inlines</Run> 

<Run FontWeight="Bold">Secondo elemento 

Inlines</Run> 
</Paragraph> 

È possibile specificare un interruzione di pagina 
e, per fare questo, occorre impostare, sul primo 
paragrafo della nuova pagina, la proprietà Break- 
PageBefore a True. In questo modo, verrà creata 
una nuova pagina il cui primo paragrafo sarà 
quello in cui abbiamo specificato BreakPageBe- 
fore. 



IL FORMATO XPS 

Con l'avvento di Windows Vista e del .NET Fra- 
mework 3.0, Microsoft, ha sviluppato un nuovo 
formato documentale chiamato, appunto, XPS. 
Questo formato si basa sulle specifiche Open 



Packaging Conventions e alle Open XML Markup 
Compatibility che descrivono come creare un 
pacchetto di contenuti in maniera standardiz- 
zata. 

Un documento XPS è, sostanzialmente, un file 
con estensione .xps. Rinominando il file in .zip è 
possibile notare (nella stessa maniera di un do- 
cumento Office 2007) come questi siano costi- 
tuiti da semplici file xml e binari per le risorse. 
Infatti, nel pacchetto, oltre al documento xml 
per il testo, vengono inclusi eventuali file ne- 
cessari alla visualizzazione dello stesso come, ad 
esempio, immagini o font. Windows Presenta- 
tion Foundation mette a disposizione dello svi- 
luppatore una serie di API per la creazione di do- 
cumenti XPS e, la base di tutto è proprio l'og- 
getto FixedDocument. Infatti un documento XPS 
è strutturato in maniera gerarchia ossia abbia- 
mo una sequenza di FixedDocument raccolti tra- 
mite un FixedDocumentSequence ed ogni docu- 
mento contiene una o più FixedPage che con- 
tengono la definizione di testo e immagini con- 
tenute nella pagina a cui si riferisce. Natural- 
mente una FixedPage viene definita tramite 
markup. 



FATTURIAMO 

ll\l FORMATO XPS 

Come abbiamo già accennato nell'introduzione 
nei casi in cui il nostro documento debba esse- 
re fedele al layout definito, occorre utilizzare un 
FixedDocument che, quindi, è progettato per ap- 
plicazioni che richiedono una precisa rappre- 
sentazione del documento a prescindere dal sup- 
porto di visualizzazione. Un caso pratico di do- 
cumento con queste caratteristiche è una fattu- 
ra commerciale che deve, quindi, rispettare una 
precisa struttura da noi definita e non deve ri- 
modellarsi in base al dispositivo come per un 
FlowDocument. 

Iniziamo con il creare, quindi, l'oggetto RigaFat- 
tura che conterrà alcune proprietà comuni del- 
le fatture come codice, descrizione, etc e una col- 
lection Fattura di tipo, naturalmente, RigaFat- 
tura. 

public class RigaFattura 

_{ 

private string codi ce Prodotto; 

private string descrizioneProdotto; 

private decimai prezzoUnitario; 

private Int32 quantità; 

public RigaFattura(string CodiceProdotto, string 

DescrizioneProdotto, decimai PrezzoUnitario, int 

Quantità) 
{ 



* 72 /Ottobre 2007 



http://www.ioprogrammo.it 



070-076:072-080 31-08-2007 16:17 Pagina 73 



Creiamo documenti in formato XPS ■ T SISTEMA 



-e- 



this.codiceProdotto = Codi ce Prodotto; 


this.descrizioneProdotto = DescrizioneProdotto; 


this.prezzollnitario = Prezzollnitario; 


this. quantità = Quantità; 


} 




pi 


blic string CodiceProdotto 


{ 


get { return codiceProdotto; } 


set { codiceProdotto = value; } 


} 




pi 


blic string DescrizioneProdotto 


{ 


get { return descrizioneProdotto; } 


set { descrizioneProdotto = value; } 


} 




pi 


blic decimai Prezzollnitario 


{ 


get { return prezzollnitario; } 


set { prezzollnitario = value; } 


} 




pi 


blic int Quantità 


{ 


get { return quantità; } 


set { quantità = value; } 


} 


} 



Niente di particolare come vedete. A questo pun- 
to definiamo la collection di questi elementi. Per 
la definizione di quest'ultima utilizzeremo un 
ObservableCollection. ObservableCollection è una 
novità introdotta con Windows Presentation 
Foundation e, a differenza delle classiche col- 
lection Generic, implementa già alcune nuove 
funzionalità di WPF come ad esempio le Depen- 
dencyProperty. Nel nostro caso, visto che l'e- 
sempio sarà molto semplice, non è davvero ne- 
cessaria ma, conviene sempre definire una col- 
lection in questo modo per, eventualmente, po- 
ter utilizzare in pieno le potenzialità di WPF. 



this.Add(new RigaFattura("EEEEE", "Jeans 

Donna", (decimal)39.90, 5)); 



public class Fattura 



ObservableCollection<RigaFattura> 



public FatturaQ 



{ 



this.Add(new RigaFatturafAAAAA", "T-Shirt 
Gialla", (decimal)19.90, 2)); 

this.Add(new RigaFattura("BBBBB", "T-Shirt 
Nera", (decimal)19.90, 5)); 

this.Add(new RigaFatturafCCCCC", "T-Shirt 
Verde", (decimal)19.90, 1)); 

this.Add(new RigaFattura("DDDDD", "Jeans 

Uomo", (decimal)49.90, 3)); 



} 



A questo punto possiamo definire la Window che 
visualizzerà la fattura. Per fare questo, naturalmente, 
utilizzare XAML definendo due pulsanti per la 
creazione della fattura e per la successiva creazione 
del file XPS della stessa e il DocumentViewer per 
la visualizzazione di quest'ultima. 

< Window x:Class="FixedSample.Windowl" 
xmlns="http://schemas. microsoft.com/winfx/2006/xaml 

/presentation" 
xmlns:x="http://schemas. microsoft.com/winfx/2006/xa 

mT_ 

Title="FatturazioneXPS" Height="463" Width = "688" 
> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="100"/> <!— Riga 

intestazione e pulsanti vari --> 
<RowDefinition/> <!— Riga del DocumentViewer-- 

> 
</Grid.RowDefinitions> 

<!— Intestazione e pulsanti vari — > 
<StackPanel Orientation="Vertical" Grid.Row="0"> 
< Label Content="Fatturiamo con XPS" 

FontSize="30" Height="50" FontWeight="Bold" 




COME INIZIARE 



Per lo sviluppo del nostro 
progetto è necessario installare i 
seguenti elementi: 

• Visual Studio 2005: l'IDE 
dedicato alla programmazione 
in .NET 

• Framework .NET 3.0: setup che 
installa le estensioni e gli 
assemblies di WPF, WCF e WWF 

• Windows SDK: 
documentazione, libreria delle 
classi ed esempi su tutto ciò 
che riguarda la piattaforma 
Windows, tra il quale anche lo 
sviluppo con .NET 3.0 

• Visual Studio 2005 extensions 
for .NET Framework 3.0 (WCF & 
WPF): estensioni del normale 
ambiente di sviluppo per 
supportare anche la 
programmazione di Windows 
Presentation Foundation. 

Tutto questo, ad eccezione di 
Visual Studio 2005, lo si può 
scaricare dal sito Microsoft. 



In alternativa alla versione 
commerciale di VS, possiamo 
utilizzare la versione gratuita 
Express, scaricabile dal sito 
Microsoft. 

E 1 necessario prestare attenzione 
all'ordine di installazione, che 
solitamente è quello indicato 
nella lista appena vista, ma che è 
bene leggere tra le note 
specifiche di ogni pacchetto di 
setup. 

Per gli sviluppatori che utilizzano 
Visual Studio 2005 su Windows 
Vista, Microsoft ha sviluppato un 
aggiornamento di Service Pack 1, 
chiamato "Visual Studio 2005 
Service Pack 1 Update for 
Windows Vista". Questo update 
rappresenta un ulteriore passo 
rispetto agli avanzamenti fatti 
con SP1 e mette a disposizione 
un'esperienza di alto livello per 
tutti gli sviluppatori che 
intendono sfruttare i vantaggi 
delle nuove caratteristiche di 
Windows Vista. 
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RIFERIMENTI 

...XML Paper 

Specif ication (XPS) è 

un formato per 

documenti. La 

caratteristica 

peculiare di esso è 

che può essere letto 

in qualsiasi hardware 

e da qualsiasi 

software. I 

documenti XPS 

possono essere 

stampati più 

velocemente, 

condivisi e archiviati 

anche in modo più 

sicuro. 

In Windows Vista è 

già presente il 

supporto per la 

generazione di 

documenti XPS 

mentre per XP e 

Windows Server è 

necessario installare 

il .NET Framework 

3.0 o l'apposito 

Viewer. 

Maggiori sul nuovo 

formato le trovate 

all'indirizzo 

www.microsoft.com/ 

whdc/xps/default.ms 

px mentre il Viewer 

per XP e Windows 

Server lo trovate 

all'indirizzo 

www.microsoft.com/ 

whdc/xps/viewxps.ms 

px. 



HorizontalContentAlignment="Center"/> 
<StackPanel Orientation="Horizontar Margin="0 5 

5"> 

<Button Content="Crea Fattura" Width="100" 

Height="30" Click="CreaFattura7> 
<Button Content="Crea XPS" Width="100" 

Height="30" Click="CreaXPS"/> 
</StackPanel> 
</StackPanel> 

<!— DocumentViewer per la visualizzazione della 

fattura — > 
< DocumentViewer x:Name="documentViewer" 

Background="AliceBlue" Grid.Row="l"/> 
</Grid> 
</Window> 



Nel code-behind andiamo a definire i vari metodi 
che utilizzeremo per creare e salvare la fattura in for- 
mato XPS. Come abbiamo già accennato in prece- 
denza, un documento XPS è formato da un Fixed- 
Document che a sua volta contiene una serie di Fìxed- 
Page. 

Assicuriamoci, innanzitutto, di importare i seguen- 
ti namespaces: 



using System; 


using System. IO; 


using System. Printing; 


using System. Windows; 


using System. Windows. Controls; 


using System. Windows. Documents; 


using System. Windows. Markup; 


using System. Windows. Media; 


using System. Windows. Shapes; 


using System. Windows. Xps; 


using System. Windows. Xps. Packaging; 



Con il seguente codice definiamo una FixedPage che 
sarà, quindi, la nostra fattura. 



static FixedPage CreateFixedPageQ 



{ 



FixedPage page = new FixedPageQ; 



page. Background = Brushes.White; 



page.Width = 816; 



page.Height = 1056; 



// Dati intestazione 



TextBlock tblntestazione = new TextBlock(); 
tblntestazione.Text = "P I P P O s.r.l."; 
tblntestazione. FontSize = 24; 
tblntestazione. FontFamily = new 

FontFamilyC'Verdana"); 



FixedPage. Setl_eft(tbIntestazione, 72); 
FixedPage. SetTop(tbIntestazione, 72); 
page.Children.Add(tblntestazione); 



TextBlock tbIndirizzo=new TextBlock(); 
tblndirizzo.Text = "Corso Italia, 123"; 
tblndirizzo. FontSize = 20; 

tbIndirizzo.FontFamily=new FontFamilyC'Verdana"); 
FixedPage. Setl_eft(tbIndirizzo, 72); 



FixedPage. SetTop(tbIndirizzo, 95); 



page.Children.Add(tblndirizzo); 



TextBlock tbCitta = new TextBlockQ; 



tbCitta.Text = "12345 Redmond (BA)"; 



tbCitta. FontSize = 20; 



tbCitta. FontFamily = new FontFamilyC'Verdana"); 



FixedPage. SetLeft(tbCitta, 72); 



FixedPage.SetTop(tbQtta, 117); 



page.Children.Add(tbCitta); 



// Data e Numero fattura 



TextBlock tbNumeroData = new TextBlockQ; 



tbNumeroData.Text : 



"Fattura n.2332 del 

31/08/2007"; 



tbNumeroData. FontSize = 18; 



tbNumeroData. FontFamily = new 

FontFamilyC'Verdana"); 
FixedPage. SetRight(tbNumeroData, 72); 



FixedPage. SetTop(tbNumeroData, 72); 
page.Children.Add(tbNumeroData); 



// Dati del cliente 

TextBlock tbCliente = new TextBlock(); 

tbCliente.Text = "Cliente: Vito Arconzo"; 

tbCliente. FontSize = 18; 

tbCliente. FontFamily = new FontFamilyC'Verdana"); 

FixedPage. SetRight(tbCliente, 72); 

FixedPage. SetTop(tbCliente, 95); 

page.Children.Add(tbCliente); 



// Linea orizzontale 

[■■■] 

// Intestazione dettaglio 

TextBlock tbCodice = new TextBlock(); 

tbCodice.Text = "CODICE"; 

tbCodice. FontSize = 16; 

tbCodice. FontFamily =new FontFamily("Tahoma"); 

tbCodice. FontWeight = FontWeights.Bold; 

FixedPage.SetLeft(tbCodice, 72); 

FixedPage. SetTop(tbCodice, 180); 
page.Children.Add(tbCodice); 



TextBlock tbDescrizione = new TextBlock(); 
tbDescrizione.Text = "DESCRIZIONE"; 
tbDescrizione. FontSize = 16; 
tbDescrizione. FontFamily = new 

FontFamilyC'Tahoma"); 
tbDescrizione. FontWeight = FontWeights.Bold; 



FixedPage. Setl_eft(tbDescrizione, 180); 
FixedPage. SetTop(tbDescrizione, 180); 
page.Children.Add(tbDescrizione); 
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TextBlock tbQuantita = new TextBlock(); 

tbQuantita.Text = "QUANTITÀ" 1 ; 

tbQuantita. FontSize = 16; 

tbQuantita. FontFamily = new FontFamily("Tahoma"); 

tbQuantita. FontWeight = FontWeights.Bold; 

FixedPage.SetLeft(tbQuantita, 430); 

FixedPage.SetTop(tbQuantita, 180); 
page.Children.Add(tbQuantita); 



tbPrezzoUnitarioDetail.Text = 

rigaFattura.PrezzoUnitario.ToString(); 
tbPrezzoUnitarioDetail. FontSize = 16; 
tbPrezzoUnitarioDetail. FontFamily = new 

FontFamily("Tahoma"); 
FixedPage.SetLeft(tbPrezzoUnitarioDetail, 630); 
FixedPage. SetTop(tbPrezzoUnitarioDetail, top); 
page.Children.Add(tbPrezzoUnitarioDetail); 




TextBlock tbPrezzoUnitario = new TextBlockQ; 



top += 30; 



-0- 



tbPrezzoUnitario.Text = "PREZZO"; 



tbPrezzoUnitario. FontSize = 16; 



tbPrezzoUnitario. FontFamily = new 

FontFamily("Tahoma"); 
tbPrezzoUnitario. FontWeight = FontWeights.Bold; 
FixedPage. Setl_eft(tbPrezzoUnitario, 630); 
FixedPage. SetTop(tbPrezzoUnitario, 180); 



page.Children.Add(tbPrezzoUnitario); 



// Linea orizzontale 



[-] 



doublé top = 230; 



Fattura fattura = new FatturaQ; 



foreach (RigaFattura rigaFattura in fattura) 



{ 



TextBlock tbCodiceDetail = new TextBlock(); 
tbCodiceDetail.Text = rigaFattura. CodiceProdotto; 
tbCodiceDetail. FontSize = 16; 
tbCodiceDetail. FontFamily = new 

FontFamily("Tahoma"); 
FixedPage. Setl_eft(tbCodiceDetail, 72); 
FixedPage. SetTop(tbCodiceDetail, top); 



page.Children.Add(tbCodiceDetail); 



TextBlock tbDescrizioneDetail = new TextBlock(); 
tbDescrizioneDetail.Text = 

rigaFattura. DescrizioneProdotto; 
tbDescrizioneDetail. FontSize = 16; 
tbDescrizioneDetail. FontFamily = new 

FontFamily("Tahoma"); 
FixedPage. Setl_eft(tbDescrizioneDetail, 180); 
FixedPage. SetTop(tbDescrizioneDetail, top); 
page.Children.Add(tbDescrizioneDetail); 



TextBlock tbQuantitaDetail = new TextBlock(); 
tbQuantitaDetail.Text = 

rigaFattura. Quantita.ToString(); 



tbQuantitaDetail. FontSize = 16; 



tbQuantitaDetail. FontFamily = new 

FontFamily("Tahoma"); 
FixedPage.Setl_eft(tbQuantitaDetail, 430); 
FixedPage. SetTop(tbQuantitaDetail, top); 
page.Children.Add(tbQuantitaDetail); 



TextBlock tbPrezzoUnitarioDetail 



new 

TextBlock(); 



return page; 



} 



Per la definizione del testo nella pagina utiliz- 
ziamo semplicemente delle TextBlock e un og- 
getto Line per le linee di separazione della te- 
stata del dettaglio. Inoltre, per stampare il det- 
taglio utilizziamo un ciclo foreach sulla collec- 
tion Fattura creata in precedenza. Nel successi- 
vo codice, invece, viene creato il FixedDocument 
che conterrà la FixedPage appena creata. 

static FixedDocument CreateFixedDocument() 

i 

FixedDocument doc = new FixedDocumentQ; 



doc.DocumentPaginator.PageSize 



new Size(96 * 
8.5, 96 * 11); 



PageContent page = new PageContent(); 
FixedPage fixedPage = CreateFixedPageQ; 



((IAddChild)page).AddChild(fixedPage); 



doc.Pages.Add(page); 



return doc; 



} 



Al FixedDocument creato, quindi, viene aggiun- 
ta la FixedPage con i dati della fattura attraverso 
il metodo Add() della collection Pages del docu- 
mento. Fatto questo possiamo definire gli even- 
ti dei pulsanti che andranno a richiamare i me- 
todi appena definiti. Gestiamo l'evento ClickO 
del pulsante che crea il documento e lo visua- 
lizza nel DocumentViewer. 

void CreaFattura(object sender, EventArgs e) 

i 

// Creazione del FixedDocument ... 

doc = CreateFixedDocument(); 

documentViewer.Document = doc; 
} 

A questo punto, cliccando sul pulsante "Crea Fat- 
tura", verrà creato il documento come mostrato 
in figura 2. 



TIPI DI 
DOCUMENTO 

In Windows 
Presentation 
Foundation 
abbiamo a 
disposizione due 
tipologie di 
documenti: 
FlowDocument e 
FixedDocument. I 
primi hanno la 
particolarità di 
adattare il 
contenuto 
automaticamente in 
base al device su 
cui vengono 
visualizzati 
riadattando le 
colonne o i 
paragrafi. 
I FixedDocument, 
invece, sono 
documenti con 
struttura fissa e 
utili, quindi, a 
situazioni in cui il 
layout non deve 
modificarsi a 
prescindere dal 
device. Nel nostro 
esempio abbiamo 
utilizzato un fattura 
che, naturalmente, 
deve avere un 
layout ben definito. 
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SISTEMA T I Creiamo documenti in formato XPS 
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~ L'AUTORE 



Vito Arconzo, sviluppa 
applicazioni sia 
Windows Forms che 
Web basate sul 
Microsoft .NET 
Framework già dalle 
prime versioni beta. In 
questo momento ciò 
che lo appassiona 
maggiormente è il 
nuovo engine intro- 
dotto con la versione 
3.0 del .NET 
Framework, Windows 
Presentation 
Foundation ed è, inol- 
tre, membro dello 
User Group 
DotNetSide 
(http://www.dotnetside.o 
rg). 
E' possibile contattar- 
lo attraverso il suo 
blog all'indirizzo 
http://blog.vitoarconzo.it 
per qualsiasi dubbio 
riguardante l'articolo 
o WPF in generale. 



La nostra fattura è finalmente creata, in manie- 
ra abbastanza semplice e già con le funzionalità 
di base del DocumentViewer possiamo operare 
su di essa con, ad esempio, zoom o navigazione 
tra pagine. La cosa interessante è che effettuan- 
do lo zoom su di essa, il testo viene nuovamen- 
te ridisegnato per far si che la qualità non venga 
persa. Infatti, come tutto in Windows Presenta- 
tion Foundation, anche i documenti sono vet- 
toriali e, soprattutto, le dimensioni sono specificate 
in dip (Device Independent Pixel) che permet- 
to una maggiore resa a qualsiasi risoluzione. 
Il prossimo passo è quello di salvare il documento 
su disco in formato XPS, operazione altrettanto 
semplice. Per fare questo occorre, naturalmen- 
te, creare un nuovo oggetto XpsDocument indi- 
cando dove il file verrà creato e, attraverso l'uti- 
lizzo di un oggetto XpsDocumentWriter scrivere 
il documento su disco. Naturalmente questo vie- 
ne fatto nell'evento Click() del pulsante "Crea 
XPS". 

void CreaXPS(object sender, EventArgs e) 

i 

if(doc == null){return;} 



try 



{ 



XpsDocument xpsd = new 
XpsDocument(@"c:\prova.xps", Fi I eAccess. Rea dWrite); 
XpsDocumentWriter xw = 
XpsDocument. CreateXpsDocumentWriter(xpsd); 



xw.Write(doc); 



xpsd.CloseQ; 



MessageBox.ShowfXPS Creato!"); 



} catch(Exception ex) 



{ 



MessageBox.Show(ex.Message); 



} 



Nel nostro esempio, il file creato viene chiama- 
to prova.xps e si trova in c:\. Cliccando sul file 
viene automaticamente aperta una nuova istan- 
za di Internet Explorer che visualizza il docu- 
mento come in figura 3. 

Un altro aspetto importante fornito da Windows 
Presentation Foundation è la possibilità di me- 
morizzare all'interno di un documento uno o 
più PrintTicket. Si tratta di una serie di proprietà 
che indicano come un'intera sequenza di docu- 
menti, un singolo documento o una singola pa- 
gina devono essere stampati. Possono essere spe- 
cifiche ad un particolare device, in funzione del- 
le PrintCapabilities, oppure generiche e hanno un 
loro scope d'azione, a livelli, partendo dalla Fixed- 
DocumentSequence fino alla FixedPage. Possia- 
mo, ad esempio, specificare che l'intera stampa 
va effettuata a qualità testuale, mentre una spe- 



cifica FixedPage, poiché contenente immagini, va- 
da stampata a qualità fotografica. Oppure alcu- 
ne pagine possono essere specifiche per essere 
stampate in orizzontale piuttosto che in verti- 
cale. Oltre a questo possiamo controllare la ri- 
soluzione, i margini, il numero di copie e la di- 
mensione della stampa. 

Per sfruttare questa caratteristica dobbiamo crea- 
re un oggetto PrintTicket e passarlo al metodo 
Write dell'oggetto XpsDocumentWriter. 

PrintTicket ticket = new PrintTicket(); 
ticket.OutputQuality = OutputQuality.Text; 
ticket. PageOrientation = PageOrientation.Portrait; 
xw.Write(doc.DocumentPaginator, ticket); 



~TOp; 



*ì * a t •» * t*w* .r* 
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Figura 3: La nostra fattura visualizzata in Internet 
Explorer 



Fatturiamo con XPS 



Mt^mà [ 



U * - ggna 



PIPPOs.r.l. 

Coreo Italia, 123 
12345 R*dmwd(BA) 



IM 



Figura 2: La nostra fattura visualizzata nel 
DocumentViewer 



CONCLUSIONI 

. Il formato XPS, stesso, nasce come alternativa 
all'ormai diffusissimo PDF ed in questo senso 
sembra essere partito con il piede giusto. È quin- 
di utile cominciare a conoscerlo e sfruttarlo an- 
che per le proprie applicazioni. In ogni caso si- 
curamente ne sentiremo parlare ancora, vedre- 
mo se scalfirà lo strapotere del PDF 

Vito Arconzo 
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I trucchi del mestiere 

Tips & TVicks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice, frutto dell'esperienza di chi programma, che solitamente non 
trovano posto nei manuali. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su Internet, altri 
ancora ci giungono dai lettori. Chi volesse contribuire, potrà inviare i suoi Tips&Tricks preferiti. Una volta selezionati, 
saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o sul Web 
all'indirizzo: cdrom.ioprogrammo.it. 
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fpHP] 



PHP 



COME POSSO CONOSCERE LA 
DIFFERENZA FRA DUE DATE 
PASSATE COME STRINGHE? 

function date_diff_as_text($tsl, $ts2) { 



_r 

$tsl = "2007-01-05 10:30:45"; 
$ts2 = "2007-01-06 10:31:46"; 
echo date_diff_as_text($tsl, $ts2); 

*/ 



$tsl = strtotime($tsl) 



$ts2 = strtotime($ts2) 



$diff = abs($tsl-$ts2) 



$sec_min = 60; 



$sec_hour = $sec_min*60; 



$sec_dias = $sec_hour*24; 



$dias = intval($diff/$sec_dias); 



$hours = intval($diff/$sec_hour)%24; 



$minutes = intval($diff/$sec_min)%60; 



$seconds = $diff%60; 



$result .= " $minutes minute" 



if ($minutes > 1) { 



$result . 



> 



if ($seconds > 0) { 



$result .= " $seconds second" 



if ($seconds > 1) { 



$result . 



> 



$result = explode(" ", $result); 



if (count($result)>2) { 
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end($result); 



$keyl = key($result); 



prev($result); 



$key2 = key($result); 



$aux = $result[$key2]; 



$aux .= " M .$result[$keyl]; 



unset($result[$keyl]); 



unset($result[$key2]); 



$result = implode(" ", $result); 



$result .= " y $aux" 



} else { 



$result = implode(" "/ $result); 



} 



if ($dias > 0) { 



$result = "$days day" 



if ($dias > 1) { 



$result . 



} 



if ($hours > 0) { 



$result .= " $hours hour" 



if ($hours > 1) { 



$result . 



> 



return $result; 



} 



COME POSSO CONOSCERE 
L'INTERVALLO DI TEMPO 
TRASCORSO FRA DUE 
TIMESTAMP? 

function callDuration($dateTimeBegin,$dateTimeEnd) { 
$dif=$dateTimeEnd - $dateTimeBegin; 



if ($minutes > 0) { 



$hours = floor($dif / 3600); 



$temp_remainder = $dif - ($hours * 3600); 
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$minutes = floor($temp_remainder / 60); 



$temp_remainder = $temp_remainder - ($minutes * 60); 



$seconds = $temp_remainder; 



// leading zero's - not bothered about hours 
$min_lead = ':'; 
if($minutes <=9) 
$min_lead .= '0'; 



$sec_lead = 



if($seconds <=9) 



$sec_lead .= '0'; 



// difference/duration returned as Hours: Mins:Secs e.g. 01:29:32 



return $hours.$min_lead.$rninutes.$sec_lead.$seconds; 



//Start of html file 



sw.Write("<html> \n <body > \n <pre style=\"font: 10px/3px 

monospace;\">"); 



Random ran = new RandomQ; 



for (int y = 0; y < bmp.Height; y=y+3) 



{ 



for (int x = 0; x < bmp.Width; x=x+3) 



{ 



int random = ran.Next(2); 



color = bmp.GetPixel(x, y); 



//write the html tag corresponding to the pixel color 



//value of random will be either 1 or 



sw.Write("<span style=\"color: 
#{0:X2}{l:X2}{2:x2};\">{3}</span>", (int)color.R, (int)color.G, 

(int)color.B, random); 



> 



sw.WriteLine("<br>"); 



//End of html file 



^ 




COME POSSO CONOSCERE LA 
LISTA DI TUTTI I DATABASE 
CONTENUTI IN UN'ISTANZA 
DI SQL SERVER? 

function callDuration($dateTimeBegin,$dateTimeEnd) { 

$dif=$dateTimeEnd - $dateTimeBegin; 

$hours = floor($dif / 3600); 

$temp_remainder = $dif - ($hours * 3600); 

$minutes = floor($temp_remainder / 60); 
$temp_remainder = $temp_remainder - ($minutes * 60); 



sw.Write("</body>\n</html>"); 



sw.Close(); 



End Sub 



B VISUAL 



BASIC.NET 



COME POSSO CONVERTIRE 
DA HTML AD RTF 

Private Sub ConvertHtmlToRTF() 
' I sample to read from html file 
Dim sHtml As String = IO.File.ReadAIIText("C:\TestHtml.htm") 
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$seconds = $temp_remainder; 



I will save it to temp folder 



// leading zero's - not bothered about hours 
$min_lead = ':'; 
if($minutes <=9) 
$min_lead .= '0'; 



$sec_lead = 



if($seconds <=9) 



$sec_lead 



// difference/duration returned as Hours: Mins:Secs e.g. 01:29:32 
return $hours.$min_lead.$minutes.$sec_lead.$seconds; 



} 



COME POSSO CONVERTIRE 
UNA BMP NELLA SUA 
RAPPRESENTAZIONE ASCII? 

StreamWriter sw = File.CreateText(outputPath); 
Color color; 



If Dir("C:\Temp", FileAttribute. Directory) = "" Then 
System. IO. Directory.CreateDirectory("C:\Temp") 
End If 



' Create rtf File 

Dim b As System. IO. TextWriter = New 

System. IO. StreamWriter("C:\Temp\test. rtf", False, 
System. Text. Encoding. Unicode) 
' Write it to rtf format 
b.Write(sHtml) 

' Clear object 

b.FlushQ 

b.CloseQ 

' Open file 

System. Diagnostics. Process. Sta rt( "C:\Temp\test. rtf") 



End Sub 
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POSIZIONAMENTO 
DEI CONTROLLI 

COME CREARE APPLICAZIONI CHE SCELGONO LA DISPOSIZIONE DEI COMPONENTI SULLA 
BASE DELLA RISOLUZIONE DEL SISTEMA O DELLA FINESTRA GRAFICA? ECCO LE TECNICHE 
PER NON DOVER MAI RICORRERE A FORM NON RIDIMENSIONABILI 



Benvenuti al nostro terzo appuntamento con 
wxWidgets. Nello scorso numero abbiamo fat- 
to grandi passi avanti, e ora siamo in grado di crea- 
re finestre, riempirle di controlli a nostro piacimento, 
e far rispondere l'applicazione alle richieste dell'u- 
tente per mezzo delle Event Table. Se non ci credete, da- 
te un'occhiata al wxTelefono in figura 1: l'abbiamo fat- 
to tutto da soli la volta scorsa. A dir la verità ci sono 
dei particolari di quest'esempio che ancora non van- 
no molto bene, e in questa puntata vedremo di mi- 
gliorarlo. Allargheremo così le nostre vedute a nuovi mo- 
di di intendere la disposizione dei controlli, impareremo 
a creare interfacce complesse col minimo sforzo, e in- 
trodurremo molte altre tecniche e caratteristiche di 
wxWidgets. 



■ wxTelefono |-||n| X 




i—i 


2 


3 


4 


5 


6 


7 


3 


9 


* 





# 



Fig. 1: L'applicazione wxTelefono, introdotta nello scor- 
so appuntamento 



stro vecchio wxTelefono. Semplificherò la vita ai pigri 
e a chi non ha seguito gli scorsi appuntamenti (ma- 
le!), riprendendo qui uno stralcio significativo del co- 
dice. Si tratta del costruttore del frame, in cui i con- 
trolli (cioè il display e i pulsanti) vengono creati e disposti 
al suo interno. 

PhoneFrame::PhoneFrame() : 
wxFrame(0, wxID_ANY, _T( "wxTelefono"), 
wxPoint(0,0), wxSize(188, 245)) { 
//— Crea il display — 



const wxSize DisplaySize(180, 50); 



display_ = new wxTextCtrl ( 



this, wxID_ANY, _T(""), 



wxPoint(0,0), DisplaySize 



); 



//Lo rende impossibile da modificare 



display_->SetEditable(false); 



//— Crea i pulsanti 



const wxSize ButtonSize(60, 40); 



const wxString label[4][3] = { 



{_T("1"), _T("2"), _T("3")}, 



{_T("4"), _T("5"), _T("6")}, 



{_T("7"), _T("8"), _T("9")}, 



{_T("*"), _T("0"), _T("#")> 



for (unsigned int y=0; y<4; ++y) { 
for (unsigned int x=0; x<3; ++x) { 



new wxButton ( 



this, ID_BUTTON, label[y][x], 



wxPoint ( 



x * ButtonSize.x, 



DisplaySize. y + y * ButtonSize.y 



), 



ButtonSize 




CJ CD CJ WEB 

wxWidgets3.zip 
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- Buona conoscenza 

ì-lì del C++ 



I Un compilatore C++ 
f standard 



IL VECCHIO WXTELEFONO 

Partiamo subito chiarendo cosa non mi piace del no- 



} 



Il codice crea un frame di dimensioni 188x245, con un 
display di dimensioni 180x50, e i due cicli for dispon- 



ga ^3 1^3 



Tempo di realizzazione 
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FLICKERIMG! 

Anche se qui non è 

stato fatto per ragioni 

di spazio, quando si 

usa wxAui, è buona 

norma definire gli 

eventi OnSize e 

OnEraseBackground 

del frame ospite con 

un corpo vuoto, per 

evitare fastidiosi 

sfarfalli! in caso di 

ridimensionamento. 

L'esempio su CD 

riporta il codice 

completo. 



gono una serie di pulsanti (60x40 ciascuno) in una gri- 
glia prefissata. 



I PROBLEMI DEL 

POSIZIONAMENTO 

ASSOLUTO 

Questo tipo di gestione dei controlli viene definito po- 
sizionamento assoluto, e viene adottato da molti si- 
stemi RAD, fra i quali è emblematico l'esempio di Vi- 
sual Basic. Il posizionamento assoluto, infatti, è in- 
tuitivo e facile da implementare. 
Purtroppo la scarsa fama di cui godono i program- 
matori Visual Basic per quanto riguarda la flessibilità 
delle interfacce, testimonia il fatto che il posiziona- 
mento assoluto impone alle applicazioni diversi svan- 
taggi: 

• Scarsa portabilità: non esiste alcuno standard che 
regoli le forme e le dimensioni dei controlli. Ogni 
sistema operativo usa pulsanti e finestre diversi, con 
bordi più o meno grandi, diversa gestione dei menù, 
delle barre, eccetera. Pertanto se usate il posiziona- 
mento assoluto, preparatevi a dozzine di e-mail di 
utenti insoddisfatti perché nel loro irrinunciabile 
window manager il vostro programma diventa inu- 
tilizzabile. 

• Dipendenza dalla risoluzione: anche all'interno 
dello stesso sistema operativo, risoluzioni video dif- 
ferenti da quella in cui il sistema è stato progettato 
possono mandare all'aria le dimensioni precalco- 
late, costringendovi a ridicoli messaggi del tipo: "per 
quest'applicazione è consigliata/necessaria una 
risoluzione di 800x600". 

• Scarsa flessibilità: gli utenti vogliono personaliz- 
zare la loro applicazione, organizzando il contenu- 
to e la disposizione dei controlli. Il posizionamen- 
to assoluto non glielo permette, restituendogli in- 
vece un mondo preconfigurato e immutabile. 

• Codice illeggibile e farraginoso: il posizionamento 
assoluto impone la memorizzazione di costanti ma- 
giche all'interno del codice sorgente, peggiorando- 
ne la leggibilità. Il codice diventa inoltre difficile da 
manutenere: piccole variazioni del design dell'ap- 
plicazione {"Aggiungiamo un secondo display un 
po' più in basso") portano inevitabilmente ad una 
cascata di modifiche ad-hoc {"Allora dobbiamo cam- 
biare il posizionamento di tutti i pulsanti, allungare 
la finestra, e..."). 

Per queste (e altre!) ragioni, quella del posizionamento 
assoluto è un'idea ingenua e dannosa. Questo è vero 
soprattutto nel nostro caso, dato che se usate wxWid- 
gets probabilmente desiderate che il vostro program- 
ma sia cross-platform. Pertanto: rinunciate anche so- 
lo all'idea di poter comunicare al programma delle di- 
mensioni assolute. 



Le vie più sensate, invece, sono fondamentalmente 
due, spesso in sinergia fra loro: 

1) Affidare il layout al programma, dandogli even- 
tualmente dei suggerimenti su come suddividere 
lo spazio fra i vari controlli in termini di proporzio- 
ni, e sulle dimensioni minime e massime. 

2) Affidare il layout all'utente. In questo modo non 
solo non dovrete preoccuparvi di studiarne uno per- 
fetto, ma farete anche felici i destinatari della vostra 
applicazione, permettendo loro di personalizzarla 
secondo le proprie necessità e il grado esperienza 
che hanno raggiunto. 

In questa puntata vedremo alcuni degli strumenti che 
wxWidgets offre per raggiungere questi encomiabili 
obiettivi: sizer, contenitori per il posizionamento di- 
namico (come wxPanel e wxSplitterWindow), e veri 
e propri framework per il layout avanzato dei com- 
ponenti (come wxAui) . 



UTILIZZIAMO I SIZER 

Il concetto alla base dei sizer è un po' un classico dei pat- 
tern ad oggetti, e quindi suonerà familiare ad alcuni 
programmatori che vengono da altri framework - ad 
esempio ai Javisti che vengono da AWT. 
L'idea è di affidare i controlli a degli oggetti che si oc- 
cupino di organizzarne la disposizione all'interno del- 
la finestra automaticamente. In wxWidgets tali oggetti 
intelligenti vengono chiamati sizer e derivano tutti 
dalla classe base wxSizer. Il sizer più semplice è wxBox- 
Sizer, che si occupa di disporre i controlli che gli ven- 
gono affidati in fila (se orientato orizzontalmente) o 
in colonna (se orientato verticalmente). 
Per vedere un sizer in azione, cominciamo a ritocca- 
re il costruttore di PhoneFrame: 

PhoneFrame::PhoneFrame() : 
wxFrame(0, wxID_ANY, _T("wxTelefono")) 

i 

//creiamo un BoxSizer verticale 
wxBoxSizer* sizer = new 

wxBoxSizer(wxVERTICAL); 
//lo impostiamo come sizer principale del frame 
SetSizer(sizer); 

//Creiamo il display 

display_ = new wxTextCtrl (this, wxID_ANY, _T("")); 
//Lo aggiungiamo al sizer 
s->Add(display_, 1); 
} 

Abbiamo creato un wxBoxSizer verticale, che abbia- 
mo associato al frame come sizer principale, grazie 
alla chiamata a SetSizer. Questo permetterà alla fine- 
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stra di ridimensionare il sizer (e quindi tutti i control- 
li ad esso affidati) ogniqualvolta sarà necessario. 
Quindi affidiamo il display al sizer, richiamando la 
funzione membro Add. Il risultato dell'esecuzione è 
visibile in figura 2a. 




Fig. 2: II display 

a) Con un wxBoxSizer verticale 

b) Più WX_EXPAND 

e) Più un bordo applicato a tutti e quattro i lati 



l 

DI WXSIZER::ADD 

La funzione membro wxSizerrAdd è importantissima 
e molto flessibile, grazie al gran numero di parametri 
e di cui dispone. La marcatura (o meglio, la parte più 
importante della marcatura!) è questa: 

wxSizerltem* Add(wxWindow* controllo, int 

proporzione = 0, int flag = 0, int bordo = 0) 

Vediamo un po' in che modo i vari parametri influen- 
zano il comportamento del sizer. 
Notate che nella figura 2 il sizer ha allungato automa- 
ticamente il display, in modo da fargli riempire verti- 
calmente tutto lo spazio della finestra. Se provate a ri- 
dimensionare il frame, il display lo seguirà accorcian- 
dosi. Questo comportamento è dovuto al fatto che ab- 
biamo passato 1 come secondo parametro. Vedremo 
meglio il comportamento di proporzione più avanti: 
per ora vi basti sapere che se non volete che il con- 
trollo si espanda, basterà passare come secondo pa- 
rametro, oppure non passarlo affatto. 
Notate anche che il display si espande solo vertical- 
mente, ma non orizzontalmente. Ciò deriva dal fatto 
che il sizer organizza lo spazio secondo il suo orien- 
tamento - e in questo caso è stato costruito come wx- 
Vertical. Se volete far crescere il controllo anche nell'altra 
direzione, potete impostare il terzo parametro su wx- 
EXPAND. Se nel codice precedente, quindi, modifi- 
chiamo la chiamata ad Add così: 



per modificare le impostazioni di allineamento del 

controllo. 

Notate, infine, che il display si espande fino a toccare 

il bordo della finestra. Se vogliamo associare uno o più 

margini, possiamo usare il quarto parametro. 

s->Add(display_, 1, wxEXPAND | wxALL, 20); 

Il risultato è visibile in figura 2c. 

Notate che abbiamo dovuto aggiungere anche un flag, 
wxALL, che indica di applicare il bordo a tutti i lati. In 
effetti la chiamata non è che un'abbreviazione di: 

s->Add(display_, 1, wxEXPAND | wxUP | 

wxRIGHT | wxDOWN | wxLEFT, 20); 

Se si vuole applicare il bordo solo ad alcuni dei lati, 
quindi, è possibile indicarli per composizione. 



GESTIRE LE PROPORZIONI 

Giunti fin qui, direi che è ora di smetterla di strapazzare 
quel povero display! Dobbiamo costruire con i sizer 
tutto il wxTelefono. Concentriamoci sul piano di la- 
voro, visibile in Figura 3. 
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Fig. 3: Organizzazione degli spazi nel sizer 

La figura mostra la suddivisione degli spazi all'interno 
della finestra: notate che è stata disegnata su carta 
quadrettata, per farvi calcolare meglio le proporzioni 
- a noi interessano solo quelle verticali. 

• 3 quadretti per il display. 

• 2 quadretti per uno spazio intermedio 

• 14 quadretti per la pulsantiera 
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s->Add(display_, 1, wxEXPAND); 
il risultato sarà quello in figura 2b. 
wxEXPAND è uno dei tanti flag che si possono associare, 



Ora potete capire meglio lo scopo del secondo parametro 
di wxSizer::Add: indicare le proporzioni. Perii display, 
ad esempio, scriveremo: 

s->Add(display_, 3, wxEXPAND); 
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Indicando per gli altri elementi le proporzioni 2 e 14, 
il sizer sarà in grado di calcolare e distribuire lo spa- 
zio fra i componenti. Questo ci consente di lasciare 
inalterato l'aspetto grafico della nostra applicazione 
in caso di resize. 



di wxSizer per tutte le esigenze! Un wxGridSizer si oc- 
cupa automaticamente di gestire una griglia di n x m 
controlli. Le dimensioni vengono passate all'interno 
del costruttore, e i controlli vengono incasellati uno 
alla volta, dall'alto in basso e da sinistra a destra, ogni 
volta che si richiama la funzione Add. 
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SPAZIATORI 

Il secondo elemento della lista è uno spazio vuoto, di 
due quadretti. Potremmo crearlo facilmente usando un 
controllo trasparente, come uno StaticText con label vuo- 
ta. 

In realtà wxWidgets permette di cavarsela molto più age- 
volmente, senza dover creare alcun inutile controllo: 
basta aggiungere uno spaziatore, richiamando le fun- 
zioni membro AddSpacer e AddStretchSpacer. Que- 
st'ultimo crea uno spaziatore che si espande secon- 
do la proporzione indicata nel parametro. Nel nostro 
caso, useremo: 

s->AddStretchSpacer(2); 



SIZER NIDIFICATI 

Ora rimane solo l'ultimo elemento, la pulsantiera. In 
effetti, è anche il più complicato: sono dodici pulsan- 
ti, disposti su quattro file. Come risolvere il problema? 
Il trucco è: annidare altri sizer. Un sizer, infatti, può tran- 
quillamente contenerne un altro di qualsiasi tipo - è 
una tecnica che viene usata spesso. 
Annidando più sizer potremmo cavarcela piuttosto 
agevolmente anche soltanto con gli strumenti visti fi- 
nora. Ad esempio, potremmo seguire la figura 4: usa- 
re un sizer verticale, contenente quattro sizer oriz- 
zontali, contenenti tre pulsanti ciascuno. Se volete im- 
pratichirvi con wxWidgets, vi invito calorosamente ad 
implementare questa soluzione, ma noi qui ne segui- 
remo una ancora più semplice: useremo un wxGrid- 
Sizer. Non dimenticatevi, infatti, che esistono eredi 
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Fig. 4: Come costruire la pulsantiera con una 
gerarchia di wxBoxSizer innestati. 
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WXTELEFONO 
CORI I SIZER 

Ecco, quindi, il codice del costruttore del nostro nuo- 
vo wxTelefono, ottenuto grazie ai sizer: 

PhoneFrame::PhoneFrame() : 
wxFrame(0, wxID_ANY, _T("wxTelefono")) { 

wxPanel* panel = new wxPanel(this); 

wxBoxSizer* sizer = new 
wxBoxSizer(wxVERTICAL) ; 

panel->SetSizer(sizer); 



//Aggiunge il display 



display_ = new wxTextCtrl (panel, wxID_ANY, 



_T("")); 



display_->SetEditable(false); 



sizer->Add(display_, 3, wxEXPAND); 



//Aggiunge lo spaziatore 



sizer->AddStretchSpacer(2); 



//Aggiunge la pulsantiera 



wxGrid Sizer* buttonSizer = new wxGridSizer(3, 



4); 



sizer->Add(buttonSizer, 14, wxEXPAND); 
const wxString labels(_T("123456789*0#")); 



for (unsigned int i=0; i < labels.length(); ++i) { 
wxButton* button = new wxButton( 

panel, ID_BUTTON, wxString(_T("&")) + 

labels[i] 

); 



buttonSizer->Add(button, 1, wxEXPAND | 



wxALL, 3); 



> 



> 



Dal codice sono sparite tutte quelle orrende costanti 
magiche, e il ciclo for si è notevolmente ridotto. Gra- 
zie a wxGridSizer, infatti, i controlli vengono inseriti 
in sequenza e non è più neanche necessario memorizzare 
le label in una matrice: una semplice stringa è suffi- 
ciente. Il risultato potete vederlo in Figura 5. Sembra 
pure più bello, non vi pare? 



USIAMO UM WXPANEL 

D'accordo, il telefono in Figura 5 è effettivamente 
più bello, e ci sono cose del codice che non ho spie- 
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Fig. 5: wxTelefono implementato con sizer e 
pannelli. 

gato. Se non vi siete accorti di niente (male!), vi fac- 
cio notare che lo sfondo della finestra è cambiato 
in un colore più salutare, che sotto ai numeri so- 
no comparse delle strane barrette, e che il merito 
è di quel controllo wxPanel che ho infilato nel co- 
dice senza che ve ne accorgeste. Quella di asso- 
ciare un pannello ad un wxFrame, dovrebbe esse- 
re considerata una pratica obbligatoria. La ragio- 
ne sta nel fatto che alcuni window manager non 
supportano bene il disegno diretto su un wxFrame 
e potrebbero fare strani scherzi. Inoltre, wxPanel im- 
plementa anche tante funzionalità di base che po- 
trebbero non trovarsi nella finestra ospite. Ad esem- 
pio, vi siete accorti che in un wxFrame non potete 
usare i tasti freccia e tab per spostarvi da un pulsante 
all'altro? Con un wxPanel invece, sì. Un wxPanel, in- 
fatti, reagisce automaticamente agli eventi della 
tastiera, e questo ha a che fare direttamente con 
quelle barrette sotto i numerini. Se guardate il co- 
dice all'interno del ciclo for, noterete l'istruzione: 

wxString(_T("&")) + labels[i] 



zare la nostra prima strategia: affidare il layout dei con- 
trolli alla nostra stessa applicazione. 
Come abbiamo visto, una strategia ancora più furba, 
versatile ed efficace è lasciare quest'incombenza al- 
l'utente finale. Perfino nel nostro esempio, per quan- 
to minimo, qualche utente potrebbe non gradire le 
proporzioni che abbiamo predisposto. Alcuni prefe- 
riranno, magari, un telefono come quello mostrato in 
Figura 6, con un display molto lungo e una pulsantie- 
ra ridotta, in basso. 

Per lasciare che sia l'utente a scegliere una fra le infi- 
nite proporzioni possibili, possiamo usare un conte- 
nitore speciale: wxSplitterWindow. Un wxSplitter- 
Window contiene esattamente due finestre (ovverosia 
due wxWindowo derivati), separate - orizzontalmente 
o verticalmente - da un piccolo bordo che l'utente può 
trascinare a piacimento, modificando così il rapporto 
fra le loro dimensioni. Sembra fatto apposta per usar- 




Fig. 6: L'utente ha allungato il display, grazie a 
wxSplitterWindow. 




Con questa concatenazione, ogni pulsante si trova ad 
avere come label il proprio numero, preceduto dal 
simbolo di ampersand. Questo simbolo ha un signifi- 
cato molto specifico in wxWidgets: serve ad indicare 
una scorciatoia da tastiera, applicata al carattere im- 
mediatamente successivo. Così, potete scrivere un 
numero di telefono via tastiera, senza toccare il mou- 
se. Il merito, dietro le scene, è proprio del pannello, 
che si occupa di gestire gli eventi. Come vedete, i pan- 
nelli sono molto più utili di quanto non possano sem- 
brare a prima vista. Potete usarli ogni volta che avete 
dei gruppi di controlli ai quali volete dare un corpo 
unitario, trattandoli come se fossero una finestra a tut- 
ti gli effetti. 



WXSPLITTERWINDOW 

Grazie ai sizer, quindi, siamo stati in grado di realiz- 



lo nel nostro caso: separeremo il display dalla pul- 
santiera. C'è un problema, però: mentre il display è 
un controllo (ovverosia una classe derivata da wxWin- 
dow), la pulsantiera è un semplice wxGridSizer. Quin- 
di non possiamo metterla direttamente nello splitter. 
Se avete letto attentamente il paragrafo precedente, 
avrete già intuito la soluzione: i wxPanel sono i mi- 
gliori amici dei designer. 

PhoneFrame()::PhoneFrame() : 
wxFrame(0, wxID_ANY, _T( "wxTelefono")) { 
//crea la splitter window 
wxSplitterWindow* splitter = new 

wxSplitterWindow(this); 
//Crea il display 



display_ = new wxTextCtrl (splitter, 

wxID_ANY, 



_t("")); 



//Crea un pannello con la pulsantiera 



wxPanel* buttonPanel = new 



Ottobre 2007/ 83 ». 



-e- 



wxPanel(splitter); 



wxGridSizer* buttonSizer = new 

wxGridSizer(3, 4); 
buttonPanel->SetSizer(buttonSizer); 

for (unsigned int i=0; i < labels.length(); ++i) { 
wxButton* button = new wxButton( 
buttonPanel, ID_BUTTON, 
wxString(_T("&")) + labels[i] 

); 

buttonSizer- >Add(button, 0, wxEXPAND); 



> 



//inserisce display e pulsantiera nello splitter 



splitter->SplitHorizontally(display_ 



buttonPanel, 0); 



> 



Come vedete dal codice, l'unico cambiamento so- 
stanziale è l'aggiunta dello splitter, e l'inserimento dei 
pulsanti in buttonPanel 

Infine, una volta creati i controlli, è necessario indi- 
care allo splitter di fare il suo lavoro: richiamiamo la 
funzione membro SplitHorizontally, per creare una 
bella divisione modificabile fra display e buttonPanel. 



MASSIMO RIUTILIZZO 

Seguendo il principio esposto nel paragrafo prece- 
dente, è possibile costruire intere applicazioni dai con- 
trolli ridimensionabili. Un metodo potrebbe essere 
quello di utilizzare delle gerarchie di oggetti wxSplit- 
terWindow, proprio come si fa normalmente con i si- 
zer. Il risultato sarebbe senz'altro interessante e flessibile, 
ma probabilmente il codice e la progettazione risen- 
tirebbe un po' di tante suddivisioni. Rendere i con- 
trolli ridimensionabili, poi, non è certo sufficiente. Oc- 
corre anche che l'utente possa salvare in qualche ma- 
niera le sue preferenze, in modo da trovare tutto a po- 
sto ad ogni riawio del programma e non essere co- 
stretto, ogni volta, ad un inutile lavoro manuale. E per 
dirla tutta, nei programmi più avanzati, il semplice ri- 
dimensionamento è il primo passo. I pannelli e i com- 
ponenti possono essere spostati in giro per lo schermo, 
ancorati ai bordi della finestra, e incastrati l'uno al- 
l'altro in modo da formare blocchi di controlli ridi- 
mensionabili, in maniera assolutamente dinamica. 
Se programmate con Visual Studio Express, avete un 
ambiente simile proprio davanti a voi: potete sposta- 
re le numerose finestre dell'IDE, ancorarle, chiuderle, 
riaprirle. . . Creare un simile meccanismo a mano con 
wxWidgets, per ogni applicazione, sarebbe uno sfor- 
zo immane. Proprio per questo sono nati diversi pro- 
getti per permettere il riutilizzo di interfacce avanza- 
te. Il più avanzato si chiama wxAui, ed è stato inseri- 
to ufficialmente in wxWidgets soltanto di recente. Gra- 
zie a wxAui possiamo inserire il display e la tastiera di 
wxTelefono in un vero e proprio ambiente gestito. 



UM WXTELEFONO 
"CESTITO" 

Per poter programmare con wxAui è necessario in- 
cludere il file "wx/aui/aui.h ', e aggiungere all'elenco del- 
le librerie in ingresso la voce: wxmsw28d_aui.lib (o la 
libreria corrispondente secondo la vostra configurazione. 
Ad esempio, per la versione debug unicode: wxm- 
sw28ud_aui.lib). Il cardine di wxAui è la classe wx- 
AuiManager, che viene associata ad un frame princi- 
pale (il nostro PhoneFramé) e che si occupa di "gesti- 
re" una serie di finestre o pannelli (i nostri display '_ e 
buttonPanel) . La nostra classe wxPhoneFrame, quin- 
di, incorporerà un nuovo oggetto (che chiameremo 
auiManager) di tipo wxAuiManager, e il suo costrut- 
tore cambierà così: 

PhoneFramé: :PhoneFrame() : 
wxFrame(0, wxID_ANY, _T("wxTelefono")) { 
auiManager. SetManagedWindow(this); 
//Aggiunge il display 



display_ = new wxTextCtrl(this, wxID_ANY, 



_T("")); 



display_->SetEditable(false); 



auiManager. AddPane(display_); 



auiManager.GetPane(display_). 



Name(_T("Display")). 



Caption(_T("Display")). 



PinButton(true); 



//Aggiunge la pulsantiera 



wxPanel* buttonPanel = new wxPanel(this); 



wxGridSizer* buttonSizer = 



new 

wxGridSizer(3, 4); 



buttonPanel- >SetSizer(buttonSizer); 
const wxString labels(_T("123456789*0#")); 
for (unsigned int i=0; i < 

labels.length(); ++i) { 
wxButton* button = new wxButton( 



buttonPanel, ID_BUTTON, 

wxString(_T("&")) 



labels[i] 



buttonSizer->Add(button, 0, 

wxEXPAND); 



} 



auiManager. AddPane(buttonPanel); 



auiManager.GetPane(buttonPanel). 



Name(_T("Buttons")). 



Caption(_T("Buttons")). 



PinButton(true); 



auiManager. UpdateQ; 



} 



Come vedete, si tratta di poche modifiche, ma di gran- 
de effetto. Innanzitutto abbiamo associato il mana- 
ger al nostro PhoneFramé tramite una chiamata a 
auiManager. SetManagedWindow. 
Poi, abbiamo creato dei pane contenenti il display e 
la pulsantiera, tramite le chiamate ad auiManagerAd- 
dPane. Questa funzione richiede come primo para- 
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metro la finestra da gestire, e come secondo parame- 
tro l'elenco delle proprietà del pane, sotto forma di 
wxPanelnfo. wxPanelnfo, infatti, è una classe che con- 
tiene una sfilza di funzioni membro {Name, Caption, 
PinButton. . .) ognuna delle quali permette di impo- 
stare una specifica caratteristica del pane. E ogni fun- 
zione membro restituisce a sua volta un oggetto di ti- 
po wxPanelnfo, permettendo così una curiosa sin- 
tassi, grazie alla quale è possibile cambiare una fila di 
proprietà con una sola istruzione. 
Nel codice mi sono limitato a dare un nome ad ogni pane 
(il che è bene fare sempre, soprattutto per la persi- 
stenza degli oggetti, che vedremo fra poco), una cap- 
tion, e ad aggiungergli un simpatico "pin button", pre- 
mendo il quale è possibile disancorarlo dai bordi. Do- 
po aver terminato le aggiunte, è obbligatorio richia- 
mare la funzione membro Update dell' auiManager, in 
modo da applicare le modifiche apportate. Infine, è 
fondamentale deinizializzare il manager prima del 
termine dell'applicazione. 

PhoneFrame::~PhoneFrame(){auiManager.UnInit();} 

Il risultato potete ammirarlo in Figura 7, scattata nel- 
l'istante in cui l'utente, dopo aver ancorato la pulsan- 
tiera in basso sta facendo la stessa cosa col display, in 
alto. 



PERSISTENZA 
DI PROSPETTIVE 

Ora l'utente può scegliere una fra le infinite di- 
sposizioni dei pane della tastiera e del display. 
C'è da aspettarsi che ci spenda su un bel po' di tem- 
po, ma quando si sarà deciso esigerà che l'ap- 
plicazione ricordi le sue impostazioni, senza do- 
ver rifare tutto daccapo. Grazie a wxAui, non do- 
vete preoccuparvi di spendere mesi ad imple- 
mentare un vostro sistema di persistenza: vi ba- 
sterà salvare la "prospettiva" corrente. La fun- 
zione membro SavePerspective, infatti, vi per- 
mette di ottenere una stringa contenente lo sta- 
to del manager, che potrete richiamare usando 
LeadPerspecti ve. 

void On Button (wxCom ma ndEvent& event) { 
wxButton* button = 
static_cast<wxButton*>(event.GetEventObject() 
)J_ 

display_->AppendText(button->Getl_abelText()); 



if (button->Getl_abelText() 



_T("#")) { 



wifstream file("impostazioni"); 



if (button- >GetLabelText() 



_T("*")) { 



wofstream file("impostazioni"); 



wxString tmp =auiManager.SavePerspective(); 



file << tmp.c_str(); 



wstring tmp; file >> tmp; 



auiManager. LoadPerspective(tmp); 



} 



In questo codice, ho abbinato SavePerspective e 
LoadPerspective rispettivamente ai tasti "*" e "#" 
del telefono, per permettervi di giocarci dina- 
micamente. La prassi più consueta, invece, è sal- 
vare le impostazioni immediatamente prima del- 
l'uscita dal programma, e caricarle nel costruttore. 
Per la persistenza, come vedete, mi è bastato usa- 
re gli stream standard, salvando le informazioni 
in un file - ma se volete un sistema più elabora- 
to, vi consiglio di studiare la classe wxConflg. 



CONCLUSIONI 

Siamo partiti da un semplice wxTelefono statico e, 
via via, ci siamo fatti strada verso soluzioni più di- 
namiche, fino ad arrivare ad una gestione degna 
degli ambienti più raffinati. L'insieme di funzio- 
nalità, controlli, e personalizzazioni offerti da wx- 
Aui è impressionante, e quanto visto in queste pa- 
gine può solo considerarsi un piccolo antipasto. 
Spero che questo breve viaggio sia servito a inco- 
raggiarvi nella creazione di applicazioni basate su 
sizer e manager, e centrate sull'utente anziché sul- 
lo sviluppatore. Il nostro viaggio alla scoperta di 
wxWidgets continua il mese prossimo, con altri ar- 
gomenti. Non mancate! 

Roberto Allegra 



h 


_ 

K 

1 

Buttons JJ X | 
1 2 3 

4 5 6 

7 8 9 

* # 




Il sito 

www.robertoallegra.it 
contiene l'elenco degli 
articoli pubblicati in 
questa rubrica, con gli 
inevitabili 

approfondimenti ed 
errata corrige. L'e-mail 
dell'autore è 
posta@robertoallegra.it. 



Fig. 7: Il wxTelefono gestito da wxAui. 
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SFRUTTARE 
TUTTE LE RISORSE 

VB.NET E GLI STRUMENTI RAD CHE MICROSOFT HA RESO DISPONIBILE PER LA 
PROGRAMMAZIONE DEI DISPOSITIVI MOBILI RENDONO LO SVILUPPO DI UN'APPLICAZIONE 
UN'OPERAZIONE NON DIFFICILE. MA COME FARE PER OTTENERE LE MASSIME PRESTAZIONI? 
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— Conoscenze di base 
LJ sulla programmazione 



Microsoft Visual 
Studio.NET 2005, 
Windows Mobile 5.0 
Smartphone SDK 




Imparare a programmare un PPC o uno 
Smartphone con Visual Basic.NET permette di 
familiarizzare con un linguaggio già affermato 
nel mondo dei programmatori, ma che sta diven- 
tando sempre più importante in tutti gli ambienti 
di lavoro. La stessa mitica Ferrari, il non plus ultra 
della ricerca della perfezione ed una delle aziende 
più votate al miglioramento continuo del proprio 
prodotto, utilizza Visual Basic per sviluppare parte 
dei progetti necessari alla propria scuderia 
f http://news.com.com/Ferraris+high-tech+tune- 
up/2008-1012 3-5344866.html) . 




Fig. 1: L'applicazione Globular Cluster mentre viene 
eseguita all'interno dell'emulatore per Smartphone 



PARTICOLARITÀ DELLE 
APPLICAZIONI MOBILI 

In questo articolo imparerete a creare semplici ani- 
mazioni e fare i conti con le risorse limitate di uno 
dei minicomputer "meno attrezzati" che ci siano in 
circolazione: il telefono cellulare intelligente, lo 
Smartphone. I dispositivi mobili in effetti diventa- 
no sempre più potenti mano a mano che vengono 
introdotte nuove versioni sul mercato. Tuttavia essi 
sono ancora molto meno potenti dei computer 
desktop. Le loro limitazioni hardware sono chiara- 
mente un fattore da tenere in considerazione in 
fase di sviluppo di programmi. 
La differenza in capacità di elaborazione tra PC 
desktop e device mobili è veramente rilevante. Un 
tipico PC ha ormai almeno 1 GHz di processore, 
mentre i computer più moderni superano anche 3 
GHz. I Pocket PC possono essere dotati di CPU da 
400 MHz e gli Smartphone solitamente hanno un 
processore anche meno potente. La conseguenza 
di ciò è che le applicazioni che contengono algorit- 
mi complessi vengono eseguite su di essi con note- 
vole lentezza. 

Allo stesso modo il quantitativo di memoria 
disponibile per un'applicazione che gira su un 
dispositivo mobile è notevolmente limitata. 
Mentre un tipico PC desktop ha come minimo 
ormai almeno 512 MB di memoria, un altrettanto 
tipico smart device può disporne di un quarto in 
meno. 

E' anche importante considerare le caratteristiche 
del monitor che ha un effetto veramente significa- 
tivo su come un utente percepisce le prestazioni 
di un'applicazione. In effetti la differenza più 
ovvia rispetto a un PC sono le dimensioni del 
display. I PC possono avere anche monitor supe- 
riori a 21" mentre un tipico Pocket PC ha un pic- 
colo display LCD magari da 6x8 centimetri o poco 
più. In generale la risoluzione media di uno smart 
device è 320x240 pixel e non supera mai i 640x480, 
preistoria per i monitor da PC! In questo modo 
chiunque percepisce subito che le applicazioni 
per device mobili possiedono senza dubbio meno 
funzionalità di quelle equivalenti per PC. 
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KICK-OFF 

DEL PROGETTO 

Al solito avviate Visual Basic.NET, fate clic sul menu 
File-New project, doppio clic su Smart Device, clic 
su Windows Mobile 5.0 Smartphone e nella sezione 
Templates fate, poi, clic su Device Application. Nel 
campo Name digitate il nome del che volete dare al 
progetto, ad esempio Globular Cluster e fate clic sul 
pulsante OK. 

Innanzitutto dovete modificare alcune proprietà 
predefinite della form. Ricordatevi che per attivare 
la finestra Properties relativa ad un oggetto qualsia- 
si, dovete fare un solo clic su di esso (qui la form) e, 
poi, scegliere dal menu View la voce Properties 
oppure premere direttamente il tasto F4. Le pro- 
prietà della form da aggiornare sono le seguenti: 

- (Name)-frmOra. Si tratta qui del nome logico, 
vale perciò la pena di cambiare anche quello fisico 
e cioè il vero e proprio nome della form, visibile dal 
file system (Risorse del computer). Aprite con 
Ctrl+R il Solution Explorer, che contiene tutti i 
componenti del progetto corrente, fate un click 
destro su Forml.vb, scegliete l'opzione Renarne, 
digitate frmOra.vb e premete Invio. 

- Text-Globular Cluster. Questa è la descrizione che 
viene visualizzata sulla barra del titolo dell'applica- 
zione. 

- Backcolor-Black 

- FormFactor-Windows Mobile 5.0 Smartphone 
QVGA. Questa impostazione serve a definire il tipo 
di emulatore che deve ospitare l'applicazione a 
design time. Quello selezionato garantisce una 
risoluzione dello schermo pari a 240x320. 
Visualizzate ora la Toolbox, scegliendo dal menu 
View la voce ToolBox e fate doppio clic sull'oggetto 
Label, per riportarlo all'interno della Formi. 
Questo controllo visualizzerà l'ora corrente. Dopo 
avere fatto un solo clic sulla Label e avere premuto 
F4, impostate alcune proprietà come segue: 

- (Name)-lblOra 

- Font.Size-14 

- Font.Bold-True 

- ForeColor- DeepSkyBlue 

- Location.X-16 

- Location. Y-38 

- Size.Width=207 

- Size.Heigth=29 

- Text- cancellare il valore predefinito Labell> 

- TextAlign-TopCenter <così il testo viene sempre 
centrato> 

Siccome l'appetito vien mangiando, inserite un'al- 
tra Label che vi servirà per visualizzare la data 
odierna. Le proprietà che dovete impostare sono le 
seguenti: 

- (Name)-lblData 



- Font.Size=10 

- Font.Bold-True 

- ForeColor- Aqua 

- Location.X-2 

- Location. Y-8 

- Size.Width=227 

- Size.Heigth=22 

- Text- cancellare il valore predefinito Labell> 

- TextAlign-TopCenter 

Ora accedete al DVD allegato alla rivista e copiate la 
cartella Globular Cluster - Immagini sul disco del 
PC. Dalla Toolbox prelevate anche una PictureBox 
che ospiterà l'animazione e impostate le seguenti 
proprietà: 

- (Name)-picGC 

- Image- <fate clic sul pulsante a destra della dici- 
tura (nessuno) e nella finestra che appare indivi- 
duate la cartella con le immagini, selezionate 
BHo01.jpg e fate clic su Apri> 

- Location.X-26 

- Location. Y-82 

- Size.Width=188 

- Size.Heigth-150 
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Fig. 2: Le immagini che consentono di creare l'anima- 
zione 



Inserite, poi, un oggetto Timer dalla Toolbox. 
Questo controllo è uno dei più potenti e utili, in 
quanto esegue periodicamente gli algoritmi che 
sono stati inseriti al suo interno. Tra l'altro, al con- 
trario di altri controlli, viene sempre nascosto in 
fase di esecuzione. Le proprietà da modificare sono 
{Name) da impostare uguale a tmrOra e Interval 
che deve essere impostato uguale a 1000 perché 
l'orologio deve "girare" secondo dopo secondo. 
Interval, infatti, permette di definire la frequenza 
esprimendola in millisecondi, quindi 1000 millise- 
condi = 1 secondo. Impostate, infine, uguale a True 
la proprietà Enabled per garantire il funzionamen- 
to del Timer. 

E' anche necessario un secondo controllo di questo 
tipo per permettere il funzionamento dell'anima- 
zione in maniera indipendente dall'orologio. 





IL CONTROLLO 
TIMER 

Solo se la proprietà 
Enabled è uguale a 
True il Timer genera un 
evento Tick "attivo" 
che, cioè, viene 
verificato e avviato 
ogni x secondi, 
specificati nella 
proprietà Interval. 
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LE IMMAGINI 
DELL'ESA 

Si ringrazia l'Agenzia 

Spaziale Europea 

(http://www.esaj nt) 

per le immagini che 

hanno consentito la 

realizzazione 

dell'animazione. Esse 

rappresentano uno 

zoom eseguito dal 

telescopio spaziale 

Hubble su Globular 

Cluster NGC 2808. Dei 

150 cluster globulari 

conosciuti nella nostra 

galassia (la Via Lattea) 

NGC 2808 è uno dei più 

grandi e densi di stelle. 



Inserite, dunque, un altro Timer che chiamerete 
tmrAnima, impostando Interval uguale a 200 per 
garantire un visualizzazione sufficientemente velo- 
ce delle animazioni (ogni 200 millesimi di secondo, 
cioè ogni 2 centesimi di secondo). Come al solito 
attivate Enabled, impostandola a True. 
Se non lo avete già fatto salvate il progetto con un 
clic sulla sesta icona (dischetti multipli), indicate il 
percorso di destinazione e fate clic sul pulsante OK. 
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Fig. 3: II primo salvataggio del progetto. 



IL WINDOWS FORM 



A fronte dell'inserimento di oggetti visuali dalla 
Toolbox Visual Basic.NET crea automaticamente 
delle linee di codice che corrispondono esattamen- 
te a tutti i controlli parte del progetto. Per accedere 
a questo codice dovete attivare l'editor del codice e 
selezionare nella combo box in alto a sinistra (quel- 
la che contiene gli oggetti grafici) la form. In questo 
caso scegliete frmGlobularCluster e vedrete che 
nella combo box di destra comparirà automatica- 
mente (Declarations); selezionate al suo posto l'e- 
vento InitializeComponent che, insieme al prece- 
dente Dispose (Boolean), risulta disabilitato. A que- 
sto punto si apre una schermata che non deve esse- 
re mai modificata direttamente e che, come già 
detto, consente di vedere come il tool di sviluppo 
ha definito ed inzializzato tutti i vari elementi che 
voi avete inserito nel progetto, form inclusa. Ad 
esempio la label che contiene la data ha le caratte- 
ristiche che seguono: 

Me.lblData.Font=NewSystem.Drawing.Font("Nina",10. 

0!, System. Drawing.FontStyle.Regular) 



Me.IblData.ForeColor = 



System. Drawing.Color.Aqua 



Me. IblData. Location = New 

System. Drawing.Point(2, 8) 



Me. IblData. Name = "IblData" 



Me. IblData. Size = New 

System. Drawing.Size(227, 22) 



Me.IblData.TextAlign = 

System. Drawing.ContentAlignment.TopCenter 

Ricordate sempre che questi eventi possono essere 
aperti ed esaminati, ma è sempre meglio non 
modificare qui alcuna istruzione. Qualsiasi aggior- 
namento deve essere eseguito direttamente sugli 
oggetti nella sezione grafica. 




Fig. 4: Il Windows Form Designer.. 



CREARE L'ANIMAZIONE 

Le animazioni per essere veramente fluide necessi- 
tano di un numero non indifferente di frame: ogni 
secondo si dovrebbero avvicendare ben 25 foto- 
grammi! In questo modo si ha la garanzia di avere 
un ottimo effetto visivo, ma s'impone allo 
Smartphone un notevole sacrifìcio in termini di 
memoria allocata, che assume valori esponenziali 
mano a mano che aumenta la lunghezza tempora- 
le della nostra animazione. Nel caso d'esempio non 
vogliamo impegnare in maniera eccessiva le risor- 
se di Windows Mobile, anche perché tutto somma- 
to si tratta semplicemente di un filmato d'intratte- 
nimento che accompagna la visualizzazione dell'o- 
rologio digitale e della data odierna. Per questo 
motivo caricherete e visualizzerete solo 10 foto- 
grammi: l'effetto visivo è ugualmente piacevole, 
anche se non privo d'imperfezioni. 
Prima di tutto dovete inserire le dieci immagini nel 
progetto VB.NET. Inserite, dunque, dieci 
PictureBox sulla form e battezzatele rispettivamen- 
te picGCl, picGC2, ..., picGCIO. Aggiornate ciascuna 
proprietà Image con la rispettiva immagine da 
BHoOLjpg a BHol0.jpg. Impostate, inoltre, tutte le 
proprietà Visibile a False, per non visualizzare mai 
in fase run time queste PictureBox. 
Fate doppio clic sul secondo Timer tmrAnima e 
all'interno dell'evento Tick inserite l'algoritmo che 
segue. 

Private Sub tmrAnima_Tick(...) Handles 

tmrAnima.Tick 



»> 88 /Ottobre 2007 



-e- 



Static ctr As Integer = 


ctr += 1 


With picGC 


Select Case ctr 


Case 1 : .Image = 

2 


picGCl. Image : Case 
: .Image = picGC2. Image 


Case 3 : .Image = 
4 


picGC3. Image : Case 
: .Image = picGC4. Image 


Case 5 : .Image = 
6 


picGC5. Image : Case 
: .Image = picGC6. Image 


Case 7 : .Image = 
8 


picGC7. Image : Case 
: .Image = picGC8. Image 


Case 9 : .Image = 
10 : 


picGC9. Image : Case 
.Image = picGCIO. Image 


End Select 


End With 


If ctr = 10 Then ctr = 


End Sub 
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Fig. 5: Le proprietà delle PictureBox 

Innanzitutto notate l'utilizzo del costrutto 
With... End With che consente di portare a fattor 
comune un oggetto, eseguendo una serie di istru- 
zioni su di esso senza doverlo ripetere all'interno 
del blocco With. Senza di esso avreste dovuto ripe- 
tere picGC dieci volte, cioè tante volte quanti sono i 
Case. Osservate anche la variabile statica ctr: essen- 
do Static è visibile per l'intera durata del program- 
ma, ma solo all'interno dell'evento che lo ha inizia- 
lizzato, cioè tmrAnima_Tick; al di fuori di esso non 
è dunque possibile utilizzare il contatore ctr, dove 
risulterebbe non dichiarato. Inoltre ricordate che 
tmrAnima_Tick viene attivato automaticamente 
ogni due centesimi di secondo e ad ogni suo richia- 
mo la variabile ctr viene incrementata di una unità 
grazie all'istruzione ctr+-l che si potrebbe anche 
indicare così: ctr-ctr+1. 

Notate, poi, i due punti che separano le istruzioni 
Case, riga dopo riga: si tratta di una sintassi concisa 
consentita da Visual Basic.NET che evita di dover 
specificare una Case per ogni riga; utilizzatela solo 



se vi sembra che il programma mantenga la sua 
leggibilità. Anche la If in linea prima della End Sub 
è una sintassi ammessa e sostituisce la seguente If 
estesa: 

If ctr = 10 Then 

ctr = 

End If 

In pratica a seconda del mutare del valore della 
variabile Static ctr, che viene incrementata ad ogni 
ciclo di tmrAnima, l'immagine picGC (quella che 
abbiamo creata per prima che è anche l'unica visi- 
bile) viene inizializzata via via con le varie immagi- 
ni contenute nelle altre PictureBox. L'istruzione 
Select Case consente di valutare qual'è il valore cor- 
rente di ctr e quale immagine deve essere visualiz- 
zata. 

L'ultima imprima dell'End Sub reimposta ctr a zero, 
se il suo valore è uguale a dieci. È un'operazione 
necessaria per fare in modo che l'animazione rico- 
minci dalla prima immagine picGCl. Image. 
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Fig. 6: Nell'editor del codice è presente la casella 
combinata che contiene tutti gli oggetti 
programmabili nei vari eventi 



L'OROLOGIO 
IM FUNZIONE 

Facciamo doppio clic su tmrOra per "entrare" auto- 
maticamente nel suo evento Tick. Qui dobbiamo 
inserire il codice che consenta di mantenere 
costantemente aggiornata l'ora e la data di sistema. 
In entrambi i casi bisogna utilizzare la funzione 
predefìnita NowO, che contiene proprio data e ora 
di sistema. NowO deve, però, essere formattata, 
cioè manipolata per estrarre in un caso solo la data 
mentre nell'altro solo l'ora. A titolo esemplificativo 
provate ad inserire nell'evento Tick sia IblData. Text 
che IblOra. Text uguagliata solo a NowQ. 
Per ottenere la data bisogna applicare a NowO 
un'altra funzione predefinita di Visual Basic.NET 
cioè Formato, che deve ricevere due parametri. Il 
primo è proprio NowO, il secondo è dddd - dMMM 




ISTRUZIONE 
SELECT CASE 

Essa esegue uno dei 
vari blocchi di 
istruzioni indicati nei 
rami Case seguenti, 
sulla base del valore 
dell'espressione 
specificata proprio 
dopo la Select Case. 
Prima della End Case è 
possibile specificare il 
ramo Case Else che 
viene eseguito solo se 
nessuno dei Case 
precedenti è stato 
verificato. 
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UTILIZZARE 

IL SOFTWARE 

ALLEGATO 

Come prima cosa 

copiare l'intero 

progetto Globular 

Cluster dal DVD al 

vostro PC. Per avviarlo 

all'interno di Visual 

Basic.NET entrate nella 

cartella Globular 

Cluster e fare doppio 

clic sul file Globular 

Cluster.sln. 



yyyy, che serve a specificare che si vuole estrarre dal 
primo parametro una data nel formato: giorno 
della settimana, trattino centrale (-), numero del 
mese, prime tre lettere del mese ed infine anno. 
Per ottenere l'orario (ora, minuti e secondi) è suffi- 
ciente indicare come secondo parametro Long 
Time. 

Private Sub tmrOra_Tick(...) Handles tmrOra.Tick 
IblData.Text = Format(Now(), "dddd - d MMM 

yyyy") 

IblOra.Text = Format(Now(), "Long Time") 
End Sub 
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Fig. 7: Ecco come appare l'applicazione se non 
formattate la funzione IMowQ. 



IL MENU DI GLOBULAR 
CLUSTER 

Per concludere degnamente l'applicazione dovete 
anche progettare il menu che consenta la corretta 
uscita dal programma e di eseguire altre eventuali 
attività. L'oggetto MainMenu è presente nella 
Toolbox, tuttavia quando si crea un nuovo progetto 
viene automaticamente incorporato nella form. 
Fintanto che non viene riempito con le voci neces- 
sarie non è visibile durante la fase di run time. Per 
impostarlo fare clic su mainMenul, nella barra che 



contiene anche i controlli Timer, e digitare Esci al 
posto di Type Here. Il menu può annidarsi in sotto- 
menu, ma in questa applicazione non è necessario. 
Fate clic su Esci e selezionate la finestra delle pro- 
prietà per modificare (Nome) in mnuEsci. Fate ora 
clic a destra di Esci e ancora una volta compare 
Type Here dove dovete digitare Informazioni... 
Anche in questo caso impostate la proprietà 
(Name) battezzandola mnulnfo. Ora si tratta di 
programmare gli eventi del menu. Fate doppio clic 
su Esci e nell'evento mnuEsci_Click che appare 
digitate l'istruzione che consente di chiudere l'ap- 
plicazione: Application.ExitQ. Per chiedere una 
conferma dovete utilizzare la funzione MsgBoxQ 
come segue: 

Private Sub mnuEsci_Click(...) HandlesmnuEsci. Click 
If MsgBox("Sei sicuro di voler uscire?", _ 
MsgBoxStyle.YesNo Or 

MsgBoxStyle.DefaultButton2 Or _ 



MsgBoxStyle.Question) 



MsgBoxResult.Yes 

Then 



Application. ExitQ 



End If 



End Sub 

Il primo parametro della MsgBoxQ contiene la 
domanda posta all'utente dell'applicazione; il 
secondo è un insieme di impostazioni necessarie 
per visualizzare i pulsanti Sì e No {MsgBoxStyle.- 
YesNo), il pulsante No come predefinito [MsgBox- 
Style.De/aultButton2) e l'icona del punto interroga- 
tivo (MsgBoxStyle.Question). 
Infine nel menu Informazioni... dovete specificare 
le indicazioni relative a chi ha sviluppato il pro- 
gramma ed, eventualmente, alla versione dello 
stesso. 



IL DEBUG DEL 
PROGRAMMA 

Eseguire il debug di un programma significa let- 
teralmente togliere le cimici, spulciare, cioè ripu- 
lire l'applicazione da errori di programmazione. 
Questa fase può essere eseguita sia sull'emulato- 
re che direttamente sul device mobile. Un esem- 
pio classico di operazione di debug è la verifica 
del valore di una o più variabili: dovete premere 
F9 sulla riga dove si vuole che il programma si 
fermi e, poi dopo avere avviata la fase di run 
time, dovete premere Ctrl+G per visualizzare una 
finestra dove è possibile testare il valore delle 
variabili. Ad es. se si preme F9 su ctr+=l e si ese- 
gue l'applicazione, il flusso del programma si fer- 
merà proprio su quell'istruzione; dopo avere 
premuto Ctrl+G sarà possibile verificare nella 
finestra di Controllo immediato il valore corren- 
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te di ctr digitando ?ctr e poi premendo Invio. 
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Fig. 8: Durante la fase di debug è possibile 
verificare il valore delle variabili per correggere 
gli errori di programmazione 



A volte il debug viene eseguito anche per analiz- 
zare l'esecuzione dell'applicazione passo dopo 
passo e per individuare qual è l'istruzione ese- 
guita per prima. In questo caso premete F9 sull'i- 
struzione iniziale, ad esempio With picGC all'in- 
terno dell'evento tmrAnima_Tick e, poi, eseguire 
l'applicazione con F5, o all'interno dell'emulato- 
re o dello Smartphone. Il programma si fermerà 
appena raggiunta l'istruzione evidenziata con F9 
e potrete andare avanti passo dopo passo con il 
tasto F8 (o menu Debug-Step luto). Ricordate 
che, nel caso, siano presenti eventi asincroni, 
come quelli generati dal controllo Timer, non 
sarà possibile seguire facilmente il flusso del pro- 
gramma step by step e si potranno verificare dei 
risultati imprevedibili. 



ESECUZIONE 
E DISTRIBUIRE 
L'APPLICAZIONE 

A questo punto dovete abbinare il progetto ad 
un'icona: accedete al menu Project-Globular 
Cluster Properties e scegliete a sinistra la scheda 
Application. Nel campo Icori dell'applicazione 
fate clic a destra sul pulsante con i puntini, sele- 
zionate l'icona star.ico (presente nel DVD nella 
cartella Globular Cluster - Immagini). 
Per eseguire l'applicazione premete F5 e sceglie- 
te Windows 2005 Smartphone Device se volete 
visualizzarla direttamente nello Smartphone, 
oppure Windows 2005 Smartphone Emulator per 
attivarla all'interno dello Smartphone virtuale 
che l'ambiente di sviluppo ci mette a disposizio- 
ne. 

Per distribuire l'applicazione, una volta ultimata, 
fate clic sul menu Build e, poi, su Build Globular 
Cluster per creare la versione definitiva del file 
eseguibile. Copiate, quindi, il file Globular 
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Fig. 9: Per impostare l'icona bisogna accedere alle 
proprietà del progetto. 

Cluster.exe, presente in Globular Cluster\bin\ 
Release, all'interno dello Smartphone (in Glo- 
bular Cluster\bin\Debug è presente l'eseguibile 
che viene generato tutte le volte che si esegue il 
programma nell'emulatore). Nessun altro file 
sarà necessario perché Windows Mobile 2005 
contiene già tutte le librerie indispensabili al fun- 
zionamento delle applicazioni .NET. 

Enrico Bottari 




Fig. 10: L'applicazione in esecuzione in uno 
Smartphone i-mate SP5. 



Ottobre 2007/ 91 »> 



GESTIONE DEI DATI 
ATTRAVERSO JDBC 

LA RAPPRESENTAZIONE DELL'INFORMAZIONE È SOLO UNO DEI TANTI ASPETTI NELLA 
PROGETTAZIONE DI UN'APPLICAZIONE. UN RUOLO DI FONDAMENTALE IMPORTANZA VIENE 
RIVESTITO DALL'INTERFACCIAMENTO CON I DATABASE. ECCO COME FARE... 
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LJ applicazione che andremo a sviluppa- 
re in questo articolo riguarda una sem- 
I plice gestione di libri, il catalogo di 
una possibile biblioteca. Le informazioni che 
dovremo gestire sul database sono essenzial- 
mente due, gli utenti e i libri. La prima tabella 
ci servirà per gestire una sorta di autentica- 
zione e registrazione che deve essere fatta per 
accedere alla nostra applicazione. La seconda 
tabella invece servirà semplicemente per 
catalogare tutte le entry relative ai libri. 
L'approccio che utilizzeremo per la realizza- 
zione di questa Web Application e soprattutto 
per la gestione dei bean è abbastanza sempli- 
ce. Definiremo due bean, uno per l'utente e 
uno per il libro, che verranno utilizzati da 
diversi managed bean che sono direttamente 
collegati alle pagine con dei form. In questo 
modo avremo due diverse tipologie di bean. 
La prima è quella semplice, dove vengono 
inseriti i vari attributi che rispettano lo sche- 
ma del database e dove vengono creati i vari 
metodi get/set. La seconda tipologia invece 
riguarda i bean che gestiscono i campi dei vari 
form, dove andremo ad inserire alcuni meto- 
di per validare le informazioni, dove verranno 
inserite le action da eseguire nel caso in cui i 
campi inseriti nei vari form siano corretti. È 
proprio quest'ultimo tipo di bean, che 
dovranno gestire i semplici bean per il map- 
ping. Questo sarà possibile attraverso delle 
classi DAO (Data Access Object), che ci per- 
metteranno in maniera molto semplici di dia- 
logare con il database utilizzando le classi API 
JDBC. 



IL DATABASE 

Come database utilizzeremo in questo caso 
MySQL, dovremo configurare nella nostra 
applicazione i driver JDBC relativi. La scelta 
del database non è vincolante, soprattutto se 
non vengono utilizzate le librerie specifiche 



dei vari produttori ma ci si appoggia diretta- 
mente alle API JDBC standard. Lo schema è 
abbastanza semplice, perché non dobbiamo 
gestire nessuna relazione tra le due entità. Di 
seguito trovate le definizioni che abbiamo uti- 
lizzato per la creare queste due tabelle sul 
database MySQL 







UTENTI 




LIBRI 










PK 


USERNAME 
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ISBN 










PASSWORD 
EMAIL 










AUTORE 
TITOLO 
DESCRIZIONE 
PRESENTE 













































Fig. 1: Schema dei nostro database 



CREATE SCHEMA biblioteca* 



CREATE TABLE * biblioteca V UTENTI* ( 

* USERNAME* VARCHAR(45) NOT NULL, 

* PASSWORD* VARCHAR(45) NOT NULL, 



'EMAIL* VARCHAR(45) NOT NULL, 



PRIMARY KEY (* USERNAME*) 



) 



ENGINE = InnoDB; 



CREATE TABLE * biblioteca*.* LIBRI* ( 



*ISBN* VARCHAR(45) NOT NULL, 



* TITOLO* VARCHAR(45) NOT NULL, 



* AUTORE* VARCHAR(45) NOT NULL, 



'DESCRIZIONE* VARCHAR(45) NOT NULL, 



'PRESENTE* BOOLEAN NOT NULL, 



'PREZZO* DOUBLÉ NOT NULL, 



PRIMARY KEY (*ISBN*) 



) 



ENGINE = InnoDB; 



I BEAN PER IL MAPPIMG 
E LE CLASSI DAO 

Dobbiamo ora definire due diversi bean per 
mappare le informazioni e le relative classi 



* 92 /Ottobre 2007 



-e- 



DAO che ci permetteranno di gestire queste 
informazioni e caricarle /salvarle sul database 
attraverso Fuso dei bean. Il primo bean che 
troviamo qui di seguito è quello relativo alla 
definizione dell'utente 

package ioprogrammo.jsf.database; 
public class User { 

private String username; 



private String password; 



private String email; 



public User() { 



public String getUsernameQ { 



return username; 



} 



public void setUsername(String username) { 



this. username = username; 



> 



public String getPasswordQ { 



return password; 



} 



public void setPassword(String password) { 



this. password = password; 



} 



public String getEmailQ { 



return email; 



} 



public void setEmail(String email) { 



this. email = email; 



} 



La classe DAO che si occuperà di gestire le 
informazioni dell'utente è UserDAO, dove 
sono stati definiti dei semplici metodi statici 
che saranno poi richiamati dalla nostra appli- 
cazione JSE Qui di seguito trovate il codice 
relativo alla classe UserDAO, dove vengono 
utilizzate le classiche API JDBC. 

package ioprogrammo.jsf.database; 
import java. sql. Connection; 
import java. sql. DriverManager; 
import java. sql. PreparedStatement; 
import java. sql. ResultSet; 
import java. sql. SQLException; 
import java. sql. Statement; 
public class UserDAO { 

private static String 
URI="jdbc:mysql://127.Q.Q.l:33Q6/biblioteca"; 

private static String LOGIN = "root"; 

private static String PASSWD="mysql"; 

public UserDAOQ { 



public static boolean isRegistered(String 

username) { 
boolean found=false; 



try { 



Class. forl\lame("com.mysql.jdbc. Driver"); 
Connection conn = 
DriverManager.getConnection(URI, LOGIN, PASSWD); 
PreparedStatement 
ps=conn.prepareStatement("SELECT USERNAME 
FROM BIBLIOTECA. UTENTI WHERE USERNAME = ? "); 
ps.setString(l, username); 
ResultSet rs = ps.executeQuery(); 
while (rs.next()) { 
found=true; 

} 

ps.close(); 
conn.close(); 
} catch (Exception ex) { 

System. out.println(ex.toString()); 

} 

return found; 

} 

public static String register(User user) { 
String register=""; 
boolean insert=false; 

try{ 

Class. forName("com.mysql.jdbc. Driver"); 
Connection conn = 
DriverManager.getConnection(URI, LOGIN, PASSWD); 
PreparedStatement 

ps=conn.prepareStatement("INSERT INTO 
BIBLIOTECA.UTENTI(USERNAME,PASSWORD,EMAIL) 

VALUE(?,?,?)"); 

ps.setString(l,user.getUsername()); 
ps.setString(2,user.getPassword()); 
ps.setString(3,user.getEmail()); 
int res = ps.executeUpdate(); 

if (res= = l) { 

register="ok"; 
insert=true; 



else 

register="Utente non trovato"; 




ps.closeQ; 



conn.closeQ; 



} catch (Exception ex) { 



if (linsert) 



register=ex.toString(); 



System. out.println(ex.toString()); 



> 



return register; 



> 



public static String login(User user) { 



String login=""; 



boolean found=false; 



try{ 



Class. forName("com.mysql.jdbc. Driver"); 
Connection conn = 
DriverManager.getConnection(URI, LOGIN, PASSWD); 
PreparedStatement 
ps=conn.prepareStatement("SELECT USERNAME 
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FROM BIBLIOTECA. UTENTI WHERE USERNAME = ? 
AND PASSWORD=?"); 
ps.setString(l,user.getllsername()); 
ps.setString(2,user.getPassword()); 
ResultSet rs = ps.executeQuery(); 
while (rs.next()) { 
found=true; 



> 



if (found) 



login="ok"; 



else 



login="Utente non trovato"; 



ps.closeQ; 



conn.close(); 



} catch (Exception ex) { 



if (Ifound) 



login=ex.toString(); 



System. out.println(ex.toString()); 



> 



return login; 



> 



In questa classe DAO abbiamo definito 3 
metodi che ci serviranno nella nostra applica- 
zione JSF, login(), registerf) e isRegistered(). Il 
primo verrà utilizzato per effettuare il login 
nella nostra applicazione, quindi in base allo 
username e alla password che sono stati for- 
niti ed inseriti all'interno del bean User, veri- 
fichiamo se questo utente è presente nel 
nostro database. Il secondo metodo serve 
invece per effettuare la registrazione dell'u- 
tente e isRegisteredf) verrà utilizzato per con- 
trollare la presenza o meno dello username 
nel nostro database, visto che proprio lo user- 
name è la chiave della nostra tabella. La clas- 
se Libro invece serve come bean per rappre- 
sentare i vari libri che dovremo gestire e quin- 
di devono essere inserite tutti gli attributi e 
metodi get/set relativi per gestire l'informa- 
zione relativa al libro 

package ioprogrammo.jsf.database; 
public class Libro { 

private String titolo; 

private String autore; 

private String descrizione; 

private boolean presente; 

private String isbn; 

public Libro() { 

} 

public String getTitolo() { 
return titolo; 

} 

public void setTitolo(String titolo) { 
this. titolo = titolo; 



public String getAutore() { 


return autore; 


} 


public void setAutore(String autore) { 


this. autore = autore; 


} 


public String getDescrizione() { 


return descrizione; 


} 


public void setDescrizione(String descrizione) { 


this. descrizione = descrizione; 


} 


public boolean isPresente() { 


return presente; 


} 


public boolean getPresente() { 


return presente; 


} 


public void setPresente(boolean presente) { 


this. presente = presente; 


} 


public String getlsbn() { 


return isbn; 


} 


public void setIsbn(String isbn) { 


this. isbn = isbn; 


} 


} 



In questo caso la classe DAO che utilizzeremo 
è LibroDAO, che ha 3 diversi metodi: inserto, 
alreadySavedO e retrieveAll(). I primi due ser- 
vono rispettivamente per inserire un nuovo 
libro e per sapere se un libro è già stato inseri- 
to, prendendo come chiave TISBN 
(International Standard Book Number). Il 
metodo retrieveAUO ci servirà invece per cari- 
care nella nostra applicazione tutti i libri pre- 
senti e visualizzarli poi tramite le componenti 
UI di JSF 



public static ArrayList retrieveAII() { 
ArrayList lista=new ArrayList(); 
Libro libro; 

try{ 

Class. forName("com.mysql.jdbc. Driver"); 
Connection conn = 
DriverManager.getConnection(URI, LOGIN, PASSWD); 
Statement 

statement=conn.createStatement(); 
ResultSet 

rs=statement.executeQuery("SELECT 
ISBN,TITOLO,AUTORE,DESCRIZIONE,PRESENTE 

FROM LIBRI"); 
while(rs.next()) { 
libro=new Libro(); 
libro. setIsbn(rs.getString("ISBN")); 
libro. setTitolo(rs.getString("TITOLO")); 
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libro. setAutore(rs.getStnng("AUTORE")); 
libro. setDescrizione(rs.getString("DESCRIZIONE")); 
libro. setPresente(rs.getBoolean("PRESENTE")); 

lista. add(libro); 
} 



rs.close(); 



statement. close(); 



conn.closeQ; 



} catch (Exception ex) { 



System. out.println(ex.toString()); 



} 



return lista; 



name, password ed email. Abbiamo bisogno 
che tutti e tre i campi siano riempiti quindi 
inseriremo l'attributo required="true M all'in- 



Biblioteca JSF 




Registrazione 

Registrazione utente 



Loghi 

Effettua il login 



Fig. 7: Pagina principale 
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REGISTRAZIONE 

Passiamo ora a definire le varie componenti 
che serviranno per gestire la registrazione del- 
l'utente. La pagina principale della nostra 
applicazione, index.jsp, deve semplicemente 
riportare i due diversi link per la registrazione 
e per il login dell'utente, perché vogliamo che 
solo utenti registrati possano accedere ad 
essa. 

<%@page contentType="text/html"%> 
<%@page pageEncoding = "UTF-8"%> 
<html> 
<head> 

<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 
<title>Biblioteca</title> 
</head> 
<body> 
<center> 

<img src='logo.png'> 
<table border='l'> 

<tr> 

<td> 

<h3>Registrazione</h3> 



href="./faces/register.jsp">Registrazione utente</a> 

</td> 

<td> 

<h3>Login</h3> 

<a href="./faces/login.jsp">Effettua il 

login</a> 

</td> 

</tr> 

</table> 

</center> 
</body> 
</html> 



Nella pagina relativa alla registrazione dovre- 
mo gestire il classico form, dove saranno pre- 
senti i 3 diversi campi richiesti, ovvero user- 



terno dei diversi campi di input 

<%@page contentType="text/html"%> 
<%@page pageEncoding = "UTF-8"%> 
<%@taglib prefix="f" 

uri = "http://java.sun.com/jsf/core"%> 
<%@taglib prefix="h" 

uri = "http://java.sun.com/jsf/html"%> 
<html> 
<head> 

<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 
<title>Registration page</title> 
</head> 
<body> 
<center> 

<img src='logo.png'> 

<f:view> 

<h:form id = "register-form"> 

<hlxh:outputText value="Register" 

/></hl> 

<h:message for="register-form7><br> 
<h:outputLabel value="Username:" 

for="username"/> 
<h:inputText required = "true" 

id="usemame" 
validator="#{register.validateUsername>" 
binding = "#{register.username}" /> 
<h:message for="usemame"/><br> 
<h:outputLabel value="Password:" 

for="password"/> 
<h:inputSecret required = "true" 
id="password" binding = "#{register.password}" /> 
<h:message for="password"/><br> 



<h:outputLabel value="Email:" 



for="emairy> 



<h:inputText required = "true" id = "email" 

validator="#{register.validateEmail}" 
binding = "#{register.email>" /> 
<h:message for="email7><brxbr> 



<h:panelGroup> 



<h:commandButton value="Register" 
action="#{register.register>" /> 



<h:commandButton value="Cancel" 
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ALTERNATIVE 

Invece dell'approccio 

JDBC che è stato 

utilizzato nell'articolo 

per realizzare le classi 

DAO, è possibile 

utilizzare dei 

framework opensource 

di persistenza come 

Hibernate 

http://www.hibernate.org 

/ 

iBatis 

http://ibatis.apache.org/ 

db4o 

http://www.db4o.com/ 

pBeans 

http://pbeans.sourceforge 

.net/ 

JPOX 

http://www.j pox.org/ 



immediate="true" action = "exit" /> 



</h:panelGroup> 



</h:form> 



</f:view> 



</center> 



</body> 



</html> 

Come è possibile vedere, i campi username ed 
email hanno specificato un validator, che è 
legato ad un bean che gestisce la registrazio- 
ne, che vedremo qui di seguito. Se i valori non 
rispettano la validazione che viene gestita da 
questi metodi, verrà ripresentato il form con 
accanto al campo di input un messaggio d'er- 
rore. Questo form viene gestito dal managed 
bean Register, che oltre ad avere definite le 
componenti UI che abbiamo utilizzato e due 
diversi metodi per la validazione, ha anche il 
metodo register() che serve ad effettuare la 
vera e propria registrazione 



package ioprogrammo.jsf.database; 



import javax. faces. application. FacesMessage; 
import javax. faces. component.UIComponent; 
import javax. faces. component.UIInput; 
import javax. faces. component. html. HtmIInputSecret; 
import javax. faces. component. html. HtmIInputText; 
import javax. faces. context. FacesContext; 
import javax. faces. validator. ValidatorException; 
import javax. servlet. http. HttpSession; 
public class Register { 

private HtmIInputText username; 

private HtmIInputSecret password; 

private HtmIInputText email; 

public Register() { 

} 

public void validateUsername(FacesContext 

context, UlComponent toValidate, 
Object value) throws ValidatorException { 
String username = (String) value; 
if (UserDAO.isRegistered(username)) { 
FacesMessage message = new 

FacesMessage("Username già utilizzato"); 
throw new ValidatorException(message); 

} 

} 

public void validateEmail(FacesContext context, 

UlComponent toValidate, 
Object value) throws ValidatorException { 
String email = (String) value; 
if (!email.matches(".+@.+\\.[a-z]+")) { 

((UHnput)toValidate).setValid(false); 

throw new ValidatorException(new 

FacesMessage("Email non valida")); 

} 

} 

public String registerQ { 



User user=new UserQ; 



user.setUsername(username.getValue().toString()); 
user.setPassword(password.getValue().toString()); 

user.setEmail(email.getValue().toString()); 

String register=UserDAO.register(user); 



if (register.equals("ok")) { 



FacesContext fc = 
javax. faces. context. FacesContext. getCurrentInstance( 



); 



Object 
object=fc.getApplication().getVariableResolver().resol 

veVariable(fc,"user"); 



User userS=(User)object; 



userS.setUsername(user.getUsername()); 



return "registered"; 



> 



else { 



FacesContext. getCurrentInstance().addMessage("regi 
ster-form",new FacesMessage("Registration error: 

"+register)); 



return "no-registered"; 



> 



> 



public HtmIInputText getUsernameQ { 



return username; 



> 



public void setUsername(HtmlInputText username) 

{ 



this. username = username; 



> 



public HtmIInputSecret getPasswordQ { 



return password; 



> 



public void setPassword(HtmlInputSecret 

password) { 



this. password = password; 



> 



public HtmIInputText getEmailQ { 



return email; 



> 



public void setEmail(HtmlInputText email) { 



this. email = email; 



> 



Vediamo quindi cosa viene fatto nel dettaglio 
dalla classe Register. Il metodo 
validateUsernameO è quello che viene utiliz- 
zato per la validazione del campo username 
del form di registrazione. Questo metodo con- 
trolla attraverso il metodo isRegisteredO di 
UserDAO se l'utente è già presente all'interno 
del database. In caso positivo viene sollevata 
una ValidatorException che invierà al form di 
registrazione un determinato messaggio d'er- 
rore. Il metodo validateEmailO ha un compor- 
tamento analogo, solo che in questo caso 
viene controllato il campo email utilizzando 
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una semplice espressione regolare che defini- 
sce la classica email (ovvero stringa@strin- 
ga.stringa). Abbiamo infine il metodo regi- 
ster(), quello che viene richiamato da JSF nel 
caso in cui tutte le informazioni sono state 
inserite correttamente. In questo metodo non 
facciamo altro che creare un bean User e pas- 
sarlo come argomento al metodo register() di 
UserDAO. Nel caso in cui la registrazione 
viene effettuata senza problemi il bean User 
viene inserito nella sessione della nostra Web 
Application e si procede verso il menu (attra- 
verso una navigation rule che vedremo defini- 
ta in seguito), altrimenti viene segnalato all'u- 
tente Terrore che si è verificato. 



LOGIN 

Il login della nostra applicazione funziona in 
maniera simile a quella vista precedentemente 
per la registrazione. Abbiamo quindi una pagina 
JSF con un form per l'inserimento dati, un mana- 
ged bean che gestisce questo form e che utilizza 
il DAO definito per la classe User ed un metodo 
che decide se il login è stato effettuato con suc- 
cesso. Vediamo quindi la pagina login.jsp 

<%@page contentType="text/html"%> 
<%@page pageEncoding = "UTF-8"%> 
<%@taglib prefix="f" 

uri = "http ://java.sun.com/jsf/core"%> 
<%@taglib prefix="h" 

uri = "http://java.sun.com/jsf/html"%> 
<html> 
<head> 

<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 
<title>Login Page</title> 
</head> 
<body> 
<center> 

<img src='logo.png'> 
<f:view> 

<h:form id = "login-form"> 
<hlxh:outputText value="Login" /></hl> 
<h:message for="login-form"/xbr> 
<h:outputl_abel value="Username:" 

for="username"/> 
<h:inputText required = "true" 
id = "username" binding = "#{login.usemame>" /> 
<h:message for="username7><br> 
<h :outputLabel value="Password : " 

for="password"/> 
<h:inputSecret required = "true" 
id = "password" binding = "#{login. password}" /> 
<h:message for="password'7><br><br> 
<h:panelGroup> 



<h 


commandButton value= 
action = "#{login 


'Login" 
.login}" 


/> 


<h 


commandButton value= 
immediate="true" actior 


'Cancel 
= "exit" 


/> 


</h:panelGroup> 


</h:form 


> 






</f:view> 


</center> 


</body> 


</html> 



In questo caso abbiamo due soli componenti UI, 
che servono per l'inserimento dello username e 
della password. In questo caso il managed bean 
che ci permette di gestire questo form è Login, 
attraverso il quale possiamo effettuare il vero e 
proprio login nel sistema utilizzando il metodo 
login() che viene richiamato dal nostro form 
quando i dati sono stati inseriti 



s**^ 



Biblioteca JSF 




Login 



Username: |_ 
Password: 



[ Login ][ Cancel ] 



Fig. 3: Pagina di login 



package ioprogrammo.jsf.database; 



import javax. faces. application. FacesMessage; 
import javax. faces. component. html. HtmIInputSecret; 
import javax. faces. component. html. HtmIInputText; 
import javax. faces. context.FacesContext; 
import javax. servlet. http. HttpSession; 



public class Login { 



private HtmIInputText username; 



private HtmIInputSecret password; 



public LoginQ { 



} 



public String loginQ { 



User user=new UserQ; 



user.setUsername(username.getValue().toString()); 
user.setPassword(password.getValue().toString()); 



String login =UserDAO.Iogin(user); 



if (login. equals("ok")) { 



FacesContext fc = 
javax. faces. context.FacesContext. getCurrentInstance( 



); 



HttpSession session = 
((HttpSession)fc.getExternalContext().getSession(fals 

e)); 

Object 
object=fc.getApplication().getVariableResolver(). 
resolveVariable(fc,"user"); 
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User userS=(User)object; 



userS.setUsername(user.getUsername()); 



return "logged"; 



} 



else { 



FacesContext.getCurrentInstance().addMessage("logi 
n-form",new FacesMessage("Login error: "+login)); 



return "no-logged"; 



> 



} 



public String logoutQ { 



FacesContext fc = 
javax.faces.context.FacesContext.getCurrentInstance( 



); 



HttpSession session = 
((HttpSession)fc.getExternalContext().getSession(fals 

e)); 



session. invalidate(); 



Object 
object=fc.getApplication().getVariableResolver().resol 

veVa ria ble(fc," user"); 



User userS=(User)object; 



userS=null; 



return "exit"; 



} 



public HtmIInputText getUsername() { 



return username; 



} 



public void setUsername(HtmlInputText username) 

{ 



this. username = username; 



} 



public HtmIInputSecret getPasswordQ { 



return password; 



} 



public void setPassword(HtmlInputSecret 

password) { 



this. password = password; 



} 



} 



value="#{user. username}" /></h3xbrxbr> 
<h:form> 

<a href="aggiungiLibro.jsp">Inserisci 
libro</axbr> 
<a href="lista.jsp">Consulta 

biblioteca </axbrxbrxbr> 
<h:commandButton rendered = "true" 
action = "#{login.logout>" value="Esci" /> 
</h:form> 



</f:view> 



GESTIONE DEI LIBRI 

Siamo giunti quindi alla parte relativa ai libri. 
Nella prima pagina, aggiungiLibro.jsp, dobbiamo 
realizzare il classico form che servirà poi per sal- 
vare un nuovo libro sul database. Anche in que- 
sto caso abbiamo collegato i vari campi del form 
ad un managed bean, Librolnsert, che richiama il 
metodo inserto di LibroDAO per salvare un 
nuovo libro sul database. Qui di seguito vengono 
riportati i metodi significativi della classe 
Librolnsert 

public void validateISBN(FacesContext context, 

UlComponent toValidate, 
Object value) throws ValidatorException { 
String isbn = (String) value; 

if (LibroDAO.alreadySaved(isbn)) { 

FacesMessage message = new 

FacesMessage("Libro già salvato"); 
throw new ValidatorException(message); 



_} 

public String inserto { 

Libro libro=new Libro(); 

libro. setIsbn(isbn.getValue().toString()); 

libro. setAutore(autore.getValue().toString()); 
libro. setDescrizione(descrizione.getValue().toString()) 



Il metodo login() utilizza UserDAO (e il relativo 
metodo login()) per capire se l'utente può acce- 
dere o meno. In caso positivo, il bean User viene 
registrato nella sessione e si passa direttamente 
al menu della nostra applicazione. Come potete 
vedere è stato definito anche un metodo 
logoutO, che ci permetterà successivamente di 
far uscire il nostro utente dall'applicazione. 
Dopo aver effettuato il login (oppure dopo aver 
completato la registrazione) veniamo rediretti 
verso la pagina menu.jsp, dove vengono elencati 
tre semplici link che possiamo cliccare, l'aggiun- 
ta di un libro, la lista dei libri e il logout 

<f:view> 

<img src='logo.png'> 
<h3>Ciao, <h:outputText 



libro. setTitolo(titolo.getValue().toString()); 
Nbro.setPresente(presente.isSelectedO); 
String register= LibroDAO. insert(libro); 
if (register.equals("ok")) { 
return "inserted"; 

} 

else { 
FacesContext. getCurrentInstance().addMessage("inse 
rt-form",new FacesMessage("Insert error: 
"+register)); 
return "no-inserted"; 
} 



Il metodo validateISBN serve per la validazione 
dell'input relativo al form d'inserimento del 
nuovo libro. Questo, come nel caso della registra- 
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zione dell'utente, controlla la presenza di libro 
con lo stesso ISBN (chiave della tabella LIBRI) e 
in caso positivo lancia una ValidatorException. Il 
metodo inserto invece si prende carico del salva- 
taggio del libro, creando un nuovo oggetto Libro 
e passandolo alla relativa classe DAO che si occu- 
perà della vera e propria query SQL per l'inseri- 
mento sul database. Ora per completare la nostra 
applicazione dobbiamo rappresentare la lista dei 
vari libri in una tabella. Per recuperare tutti i libri 
dal database utilizziamo un semplice managed 
bean, che viene utilizzato per avere un ArrayList 
dei libri e che viene richiamato dalla nostra pagi- 
na JSP. 

package ioprogrammo.jsf.database; 
import java. util. ArrayList; 
public class ListaLibri { 



private ArrayList libri; 



public ListaLibriQ { 



public ArrayList getLibriQ { 



libri = LibroDAO.retrieveAII(); 



return libri; 



> 



public void setLibri(ArrayList libri) { 



this. libri = libri; 



} 



Infine dobbiamo creare la pagina JSP, che uti- 
lizzerà il componente UIData di JSF per 
mostrare a schermo una semplice tabella con 
tutti i libri da noi inseriti 

<h:dataTable id="listalibri" value="#{lista. libri}" 

var="libro" border="l"> 
<h:column> 

<f:facet name="header"> 
<h:outputText 

value="Autore"/> 
</f:facet> 
<h:outputText 

value="#{libro. autore}" /> 
</h:column> 
<h:column> 

<f:facet name="header"> 
<h:outputText 

value="Titolo"/> 
</f:facet> 
<h:outputText 

value="#{libro. titolo}" /> 
</h:column> 
<h:column> 

<f:facet name="header"> 
<h:outputText 

value="ISBN"/> 
</f:facet> 



<h:outputText 

value="#{libro.isbn}" /> 



</h:column> 



<h:column> 



<f:facet name="header"> 



<h:outputText 

value="Descrizione7> 



</f:facet> 



<h:outputText 
value="#{libro. descrizione}" /> 



</h:column> 



<h:column> 



<f:facet name="header"> 



<h:outputText 

value="Presente"/> 



</f:facet> 



< h : selectBooleanCheckbox 
disabled = "true" value="#{libro. presente}" /> 



</h:column> 



</h:dataTable> 

L'ArrayList, che viene richiamato grazie alla 
classe ListaLibri, viene gestito come in un ciclo 
for, dove vengono stampate a schermo tutte le 
informazioni relative al libro, contenuto nel- 
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Fig. 4: Lista dei libri inseriti nella nostra applicazione 

l'oggetto Libro che viene caricato dal database. 

CONCLUSIONI 

Abbiamo visto uno dei tanti modi in cui è possi- 
bile gestire i bean che utilizziamo all'interno 
della nostra applicazione JSF, come salvarli e 
caricarli in memoria utilizzando delle classi DAO 
che fanno da ponte tra la nostra applicazione e il 
database. L'applicazione può essere chiaramente 
migliorata, permettendo magari la modifica e la 
cancellazione dei libri inseriti. In questo caso 
l'approccio che è stato utilizzato si è basato sul 
classico JDBC, ma un'altra opzione, molto valida, 
è quella relativa a dei framework per la persisten- 
za, che possono facilitare di molto la nostra vita, 
evitando la creazione di classi DAO con comples- 
si metodi. 

Federico Paparoni 
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In questa puntata conclusiva del corso su UML 
affronteremo altre due tipologie di diagrammi 
molto importanti: i diagrammi di macchina a 
stato e quelli di deploy. I primi consentono di 
modellare l'insieme di stati in cui può trovarsi 
un'applicazione o un progetto, definendo gli even- 
ti che portano alla transizione da uno stato all'altro. 
Il secondo tipo di diagramma consente di rappre- 
sentare la configurazione fisica dei computer su cui 
gira l'applicazione, e non solo. Infatti, UML non è 
limitato alla progettazione della struttura interna 
dell'applicazione e al suo funzionamento, ma si 
preoccupa anche degli elementi fisici di supporto 
alla stessa. 



DIAGRAMMI DI 
MACCHINA A STATO 

Tutte le applicazioni per computer che utilizziamo 
possiedono una gestione dello stato, anche se in 
alcuni casi questo potrebbe non essere evidente 
per via della semplicità delle funzionalità imple- 
mentate dal software. Un esempio di applicazione 
basata su stati potrebbe essere il tipico sistema di e- 
commerce, dove si possono identificare i seguenti 
stati (semplificati): 

1. In attesa di login da parte dell'utente. In questo 
caso il sistema è in modalità "vetrina" e le funzio- 
ni di check- out sono disabilitate. 

2. In fase di shopping. Qui il sistema supporta la 
funzione di "carrello degli acquisti" e la funzione 
di check- out e ordini passati sono attive. 

3. In fase di ordine. L'utente ha selezionato il check- 
out e il sistema sta chiedendo i dati di conferma, 
come le modalità di spedizione e pagamento. 

Ovviamente, è possibile che il punto 3 contenga un 
ulteriore insieme di stati, per esempio per mante- 
nere traccia della pagina di dati che l'utente sta 
lavorando in un dato momento, nel caso il proces- 
so di check- out sia composto da una serie di scher- 
mate successive. 



Si noti che un diagramma di macchina a stati, seb- 
bene simile, non è la stessa cosa di un diagramma 
di attività, descritto nell'articolo precedente. Le 
attività sono sequenze di cose che vengono fatte 
dall'utente, dal sistema e modellano un processo. 
Un diagramma degli stati individua invece gli stati 
in cui si può trovare l'applicazione per soddisfare le 
attività presenti nel primo tipo di diagrammi. Le 
due tipologie di modelli rappresentano quindi 
informazioni che tra loro sono trasversali. 
Solitamente uno stato identifica anche un'insieme 
di funzioni attive e disattive. Per esempio, si 
potrebbe semplificare e dire che Microsoft Word ha 
due stati: un documento è aperto per modifica, 
oppure nessun file è aperto. Nel primo stato sono 
attive una serie di funzioni, come quelle di salva- 
taggio, copia, ecc.; nel secondo queste non sono 
attive, perché non hanno senso per lo stato attuale. 



DISEGNARE DIAGRAMMI 
DI MACCHINA A STATO 

Per produrre i diagrammi UML di questo articolo 
utilizzeremo come nelle puntate precedente lo 
strumento open source Argo UML 
(http://argouml.tigris.org) . Per creare un nuovo dia- 
gramma di macchina a stato, in inglese Statechart 
Diagram, procedere come segue: 

1. avviare l'applicazione 

2. selezionare la funzione New Statechart Diagram 
sotto il menu Create 

Il programma presenta l'usuale finestra di proget- 
tazione, con una barra di strumenti specifica per il 
disegno di questo tipo di diagrammi (Figura 1). 
Vedremo tra breve come utilizzare gli elementi più 
importanti. 
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Fig. 1: Barra degli strumenti per la creazione di dia- 
grammi di macchina a stati. 
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Un diagramma di macchina a stati è caratterizzato, 
in modo similare ai diagrammi delle attività, da un 
nodo iniziale e uno finale. L'aspetto grafico di que- 
sti elementi è uniforme a quelli dei diagrammi di 
attività: rispettivamente sono rappresentati da un 
pallino pieno e un pallino vuoto con attorno un 
cerchio. Anche i singoli stati ricordano molto un'at- 
tività, in quanto sono rappresentati da riquadri 
dagli angoli arrotondati, con la differenza che gli 
stati sono caratterizzati da una linea orizzontale 
che suddivide a metà il riquadro. Nella parte supe- 
riore c'è il nome dello stato, che lo identifica univo- 
camente e ne fornisce una prima indicazione 
semantica. Si possono scorgere le icone relative a 
questi elementi in Figura 1: lo stato è la terza icona 
da sinistra, mentre l'inizio e la fine sono il nono e il 
decimo pulsante. 

Come si ricorderà dai numeri precedenti, per inse- 
rire un nuovo elemento nel diagramma è sufficien- 
te fare clic sull'elemento desiderato, per prelevarlo, 
e poi fare clic sull'area di disegno, per posizionarlo 
nel punto desiderato. 



UN PRIMO ESEMPIO 

Vediamo ora come disegnare il semplice diagram- 
ma presente in Figura 2. Rappresenta gli stati che 
può assumere una lampadina collegata a un inter- 
ruttore, una situazione che sarà familiare a tutti. 
Una lampadina può essere solo in due stati: accesa 
o spenta. Come si nota dalla Figura 2, infatti, sono 
presenti solo due riquadri, che rappresentano 
appunto questi due stati. 
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Fig. 2: Un semplice esempio di diagramma di macchina 
a stati. 



Per indicare che da uno stato è possibile passare al 
successivo si utilizzano linee che terminano con 
una punta di freccia aperta. La presenza di que- 
st'ultimo elemento permette di capire il verso della 
transizione. Nella Figura 2 si evince che dallo stato 
Acceso si può passare allo stato Spento e viceversa. 
Inoltre, si può notare la presenza di una descrizio- 
ne sulla freccia, che solitamente è l'indicazione del- 
l'azione che porta alla transizione di stato. Per 



esempio, per passare da Acceso a Spento è stata 
utilizzata la funzione "spegni", che in questo conte- 
sto equivale al premere l'interruttore della luce. Si 
sarebbe potuto anche scrivere questa frase più pro- 
lissa, dipende dal contesto per il quale è stato dise- 
gnato il diagramma. Se è destinato a utenti, funzio- 
nali o in generale deve utilizzare una visione ad alto 
livello, conterrà termini e descrizioni più generali e 
discorsive. Se invece è destinato ad analisti e pro- 
grammatori, probabilmente avrà più a che fare con 
elementi tecnici e con il codice. 
Vediamo come disegnare questo diagramma. Per 
prima cosa è necessario inserire gli elementi in 
Figura 2 come prima descritto. In secondo luogo è 
necessario tirare le frecce di transizione, cosa che è 
possibile realizzare in due modi: 

1. Facendo clic su un elemento del diagramma. A 
fianco di questo appaiono icone di frecce, che è 
possibile trascinare su un altro elemento del dia- 
gramma stesso. 

2. Facendo clic sull'icona della transizione nella 
barra degli strumenti (quinta icona da sinistra), 
facendo clic sull'elemento grafico di partenza e 
poi trascinando la linea su quello di destinazio- 
ne. 

Per inserire il nome dello stato nel riquadro è pos- 
sibile procedere in due modi: 

1. Facendo doppio clic sulla parte superiore del 
riquadro. In quella posizione viene visualizzato 
un campo di testo che è possibile compilare a 
piacimento. 

2. Facendo un singolo clic sullo stato. Nel pannello 
Properties vengono riportati i dati dell'elemento 
scelto. Qui è possibile indicare il nome dello stato 
nel campo Name. 

Si ricorda invece che la creazione di angoli nelle 
linee di transizione avviene trascinando un punto 
qualsiasi della linea stessa. 

Per inserire la descrizione sulla linea, invece, è pos- 
sibile procedere in due modi diversi: 

• Facendo doppio clic sulla linea. Viene presentato 
un campo di testo sulla linea stessa, in cui è pos- 
sibile specificare l'evento (trigger) che produce il 
cambio di stato. 

• Facendo un clic con il tasto destro sulla linea e 
selezionando New Trigger dal menu contestuale 
che viene visualizzato. Da qui è possibile sceglie- 
re tra quattro tipologie di trigger. Quella più uti- 
lizzata è il Cali Event. 

Una transizione può essere caratterizzata, oltre 
che da un evento, da una guardia. Questa rappre- 
senta una condizione, che deve essere verificata 




SUL WEB 

Per una introduzione 
facile e veloce alla 
modellazione UML, 
anche se nella sua più 
recente versione 2.0, 
su consulti il sito 
www.agilemodeling.co 
m, mantenuto da un 
noto esperto del 
settore, Scott Ambler. 



Ottobre 2007/ 101 ». 




■€+ 



UMLE 
PATTERN 

Se interessa 

approfondire UML e il 

suo rapporto con i 

Design Pattern è 

possibile consultare il 

seguente testo: 

Massimiliano Bigatti, 

"UML e Design 

Pattern. Notazioni 

grafiche e soluzioni 

per la progettazione", 

Hoepli Editore, ISBN: 

978-88-203-3657-8. 



perché si possa passare allo stato di destinazio- 
ne. Questa espressione può essere scritta in lin- 
guaggio naturale, codice nel linguaggio di pro- 
grammazione preferito oppure in OCL (Object 
Constraint Language). Quest'ultimo è un lin- 
guaggio per l'espressione di vincoli inserito nelle 
specifiche UML2. Una guardia è racchiusa tra 
parentesi quadre. 



STATI DI GIUNZIONE 

Ma i diagrammi di macchina a stato possono 
essere utilizzati anche per definire gli stati che 
può assumere un oggetto all'interno di un'appli- 
cazione. Per esempio, si consideri un'ipotetica 
applicazione per gestire le richieste di autorizza- 
zione di un ufficio pubblico, per esempio per l'u- 
tilizzo di strutture comuni. Questa potrebbe 
gestire un insieme di stati associati alla richiesta 
stessa: 

• creata (appena sottoposta all'ufficio); 

• in lavorazione (l'impiegato smista all'ufficio 
competente); 

• in valutazione (i grandi pensatori stanno deci- 
dendo); 

• approvata (la richiesta può essere soddisfatta); 

• respinta (c'è qualche motivo per cui la richie- 
sta non è accoglibile). 

Un diagramma di macchina a stati che può rap- 
presentare questa situazione è illustrato in 
Figura 3. Come si può vedere, ci sono una 
sequenza di stati e transizioni di passaggio da 
uno al successivo. In uscita dallo stato di valuta- 
zione, però, è presente uno stato di giunzione, 
rappresentato da un rombo. Da qui è possibile 
creare una biforcazione per gestire i due diversi 
esiti della valutazione. Infatti dal rombo escono 
due transizioni, ciascuna delle quali porta a uno 
stato specifico. Da questi due stati poi si arriva 
allo stato finale. 
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Fig. 3: 1 diagrammi di macchina a stati possono. 

Quando in un diagramma di macchina a stati è 
presente uno stato di giunzione è necessario spe- 
cificare una guardia che indichi la logica per cui 
si dovrebbe transitare verso uno stato piuttosto 



che verso l'altro. Questo è indispensabile, altri- 
menti non si saprebbe dove andare. In questo 
caso le guardie sono espresse in linguaggio natu- 
rale. Per inserirle è sufficiente fare clic sulla linea 
di transizione e poi selezionare l'icona [G] pre- 
sente nella barra degli strumenti. Digitare quindi 
nel campo expression del pannello Properties la 
descrizione della condizione. Opzionalmente è 
possibile indicare un nome per la guardia, ma 
questo non appare nel diagramma, serve solo a 
poter riutilizzare la stessa in un altro contesto, 
cercandola negli elementi di progetto. 



STATI COMPOSITI 

Un'altra caratteristica interessante di diagammi 
di macchina a stati è la possibilità di definire stati 
compositi. Questi particolari stati sono costituiti 
da ulteriori sottostati. Gli stati compositi sono 
rappresentati da un riquadro di stato decisamen- 
te più grande del normale, all'interno del quale è 
possibile inserire più sotto-stati che definiscono 
un livello di dettaglio maggiore. In Figura 4 è pre- 
sente un esempio che è una rielaborazione del- 
l'argomento precedente, ma focalizzato sulla 
fase di valutazione. Come si nota, questa volta la 
richiesta viene creata e subito dopo passa nello 
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Fig. 4: 1 diagrammi di macchina a stati possono. 

stato "In valutazione". 

Questo stato è composto da diversi sottostati, 
che indificano le varie fasi di valutazione. In que- 
sta ipotesi, se l'esito di uno stato non è soddisfat- 
to, non si passa al successivo. Quindi per prima 
cosa si passa alla fase di verifica della solvibilità: 
all'interno di questo stato ci saranno una serie di 
richieste di documentazione per capire se chi ha 
fatto la richiesta può pagare il compenso di 
noleggio pattuito. In caso positivo si passa alla 
fase di verifica antimafia: qui vengono richiesti i 
documenti necessari quando si opera con una 
struttura pubblica (sono necessari per gli appal- 
ti, il nostro esempio è puramente ipotetico). 
Quindi c'è la fase di intervista, anch'essa caratte- 
rizzata dalle sue attività specifiche. 
Il diagramma termina qui, ma si sarebbe potuto 
concludere con l'invio di un messaggio di con- 
ferma o di diniego a chi ha inoltrato la richiesta. 
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DIAGRAMMI DI DEPLOY 

Il termine deploy affonda le sue radici in contesto 
militare, dove veniva utilizzato per descrivere il 
posizionamento di attrezzature e truppe nel 
campo di battaglia. Nel contesto informatico ha 
assunto il significato di installazione, collaudo e 
implementazione di un sistema basato su com- 
puter o di un'applicazione. Potrebbero essere 
oggetto di deploy una nuova rete per l'azienda, 
l'installazione di un server farm, l'implementa- 
zione di una nuova applicazione in un ambiente 
di programmazione distribuita. 
Con i diagrammi di deploy è possibile disegnare 
la struttura fisica di un'applicazione distribuita, 
locale, di una configurazione di rete e così via. In 
sostanza, è possibile rappresentare le singole 
tipologie di hardware richiesto e i componenti 
fisici che realizzano il programma. Questi posso- 
no essere applicazioni, programmi, file eseguibi- 
li, file di configurazione, ecc. 
In un diagramma di deploy gli elementi fisici su 
cui può girare un software sono rappresentati da 
parallelepipedi e sono chiamati nodi. Questi pos- 
sono essere computer, dispositivi integrati, pal- 
mari, smartphone, ma anche firewall hardware o 
altri elementi simili. In generale, qualsiasi ele- 
mento fisico pertinente e necessario per il dia- 
gramma che si sta disegnando. 
Gli elementi software sono invece rappresentati 
da riquadri dei componenti e sono solitamente 
inseriti nei nodi o in altri componenti. 
Per creare un nuovo diagramma di deploy in 
ArgoUML si seleziona la funzione New 
Deployment Diagram nel menu Create. La relati- 
va barra degli strumenti è abbastanza semplice e 
consente di creare nodi, componenti e descrive- 
re relazioni. Oltre a queste funzioni sono presen- 
ti quelle basilari di ArgoUML, già viste nelle barre 
degli strumenti di tutti gli altri diagrammi e che 
consentono l'inserimento di elementi grafici 
standard e di note. 

In Figura 5 è presente un esempio di diagramma 
che descrive in modo non eccessivamente parti- 
colareggiato una classica architettura per un'ap- 
plicazione web. È stato creato utilizzando gli 
strumenti presenti nella barra nel modo usuale. 
Unico particolare: per inserire un elemento den- 
tro un altro è sufficiente trascinare il primo sul- 
l'ultimo. A sinistra si può vedere il nodo Server, in 
altre parole, un computer preposto al ruolo di 
servente. Al suo interno troviamo due compo- 
nenti: il Web Server e il Database. La presenza di 
questi due elementi all'interno del nodo server 
sta ad indicare che sul computer girano due pro- 
cessi: il server web e il server di database. 
Ovviamente, sul computer girano anche altri 
processi, altrimenti questo non funzionerà affat- 
to. Si ricordi che la logica generale dei diagrammi 



UML è quella di rappresentare i soli elementi 
essenziali e necessari per il contesto che si sta 
trattando. All'interno del Web Server gira l'appli- 
cazione web (per esempio un'applicazione scrit- 
ta in PHP). 

Il nodo a destra rappresenta invece il computer 
Client, al cui interno gira il browser. 




Fig. 5: Un esempio di diagramma di deploy. 

Questo diagramma è molto semplice, ma sareb- 
be potuto essere anche più complicato. Per 
esempio, se l'applicazione avesse fatto uso di 
un'Applet, si sarebbe potuto indicare la sua pre- 
senza in esecuzione sul browser e come archivio 
sul file system del Web Server. Tutto dipende dal- 
l'accento che si vuole dare al diagramma. 
Si noti inoltre la freccia di dipendenza che unisce 
il Client al Server: consente di indicare che il 
Client utilizza il Server. Sarebbe anche stato pos- 
sibile unire i due nodi con una linea continua, 
sulla quale riportare il protocollo di comunica- 
zione utilizzato. In questo caso sarebbe stato 
html/http. La linea continua identifica un lega- 
me più stretto e in questo caso sarebbe potuto 
essere anche appropriato. 
Un altro aspetto interessante dei diagrammi di 
deploy è che consentono di specificare, all'inter- 
no dei riquadri dei componenti o nei nodi, una 
stringa di proprietà che consente di specificare 
meglio eventuali requisiti. Per esempio, si 
potrebbe indicare che il Server deve per forza uti- 
lizzare Linux, magari perché l'applicazione sfrut- 
ta alcune caratteristiche specifiche. In questo 
caso si può aggiungere, sotto il nome del nodo, 
una stringa simile a {os=Linux}. Come si nota, le 
proprietà sono identificate da coppie chiave 
valore racchiuse tra parentesi graffe. 



CONCLUSIONI 

Con questo articolo si conclude questo breve corso 
di UML, di cui sono stati affrontati i diagrammi più 
importanti che è possibile realizzare con un utile 
strumento open source quale ArgoUML. 

Massimiliano Bigatti 
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Oggigiorno, i responsabili di un CED, so- 
no più che mai "costretti" a tranquilliz- 
zare le rispettive aziende sulle capacità 
delle proprie infrastrutture IT circa la loro ca- 
pacità di soddisfare le esigenze di business in 
maniera "economicamente" efficace. Questo 
obiettivo è certamente molto arduo da rag- 
giungere ed è "rallentato" dal tentativo di cer- 
care di ottenere gli stessi risultati con un nu- 
mero inferiore di server nelle sale CED. Il moti- 
vo di tali preoccupazioni è soprattutto economico, 
poiché, all'aumentare dei server presenti in 
azienda, aumentano le spese totali legate ad un 
maggior consumo di corrente, alla manuten- 
zione dell'hardware, ecc. 
Tutte queste problematiche, legate alle predet- 
te necessità, hanno portato alla ribalta il feno- 
meno della virtualizzazione, una tecnologia che 
da diversi anni incontra l'interesse di molte 
aziende e che tutt'oggi incuriosisce molti uten- 
ti. In quest'articolo affronteremo il tema in ma- 
niera soprattutto pratica, cercando di fare una 
panoramica sui principali concetti legati a que- 
sto mondo e a come VMWare consenta, con il 
suo Virtual Infrastructure 3, di realizzare un'ar- 
chitettura "virtuale" al di sopra di qualunque 
aspettativa. 



COS'È LA 
VIRTUALIZZAZIONE? 

Prima di procedere oltre, è doveroso cercare di ca- 
pire cosa s'intende con il termine virtualizzazione. 
Anche rischiando di entrare nella banalità e di non 
usare una terminologia propria di queste tecnolo- 
gie, cercheremo di spiegare questo termine a chi 
si avvicina ad esse per la prima volta. 
Immaginiamo innanzitutto di avere un certo 
numero di server, diciamo una decina e di volerli 
consolidare in un'unica macchina, lasciandone 
inalterate le caratteristiche principali (indiriz- 
zo IP, servizi, ecc.). Attraverso la virtualizzazio- 
ne, tutto ciò è possibile ed il risultato finale è 



quello di avere gli stessi benefici/ servizi offer- 
ti dalle 10 macchine, ma con 10 "pezzi di ferro" 
in meno. Tutto quello che accade al termine di 
questa "migrazione" è quello di avere un unico 
server all'interno del quale girano 10 oggetti 
ciascuno dei quali rappresenta uno dei predet- 
ti server. Dal punto di vista dell'utente è tutto 
traparente, perché le macchine virtuali conti- 
nueranno a svolgere il loro lavoro servendosi 
delle risorse del server che le ospita. 
Questo modo di rappresentare lo scenario che 
vede protagonisti le macchine virtualizzate e 
l'host che le ospita, è volutamente reso banale, 
ma dovrebbe rendere meglio l'idea del risulta- 
to finale che si ottiene. 

Quando parliamo di ambienti con centinaia di 
server, è evidente che il processo di migrazione da 
server fisico a server virtuale, necessità di parti- 
colari accorgimenti e che, a monte, è necessario 
dotarsi di un apposito prodotto che consenta il 
raggiungimento di questo risultato. Nel nostro 
articolo prenderemo in considerazione il pac- 
chetto di programmi studiati ad hoc per queste ope- 
razioni ed offerte da VMWare. 
La suite Virtual Infrastructure di VMWare è co- 
stituita essenzialmente da 3 prodotti principali: 

• Virtual Center: costituisce il collettore delle 
informazioni rilevate sui singoli host ESX. At- 
traverso esso è possibile ottenere informa- 
zioni su di essi, sulle virtual machine confi- 
gurate su ogni ESX oltre permettere di confi- 
gurare ogni singolo aspetto dell'intera infra- 
struttura. 

• ESX Server: rappresenta, fisicamente, l'host sul 
quale "risiedono" le virtual machine. In realtà, 
le cose non stanno esattamente così nel sen- 
so che lo Storage sul quale è possibile instal- 
lare e configurare ogni singola macchina vir- 
tuale, può essere locale all'ESX oppure, ad 
esempio, far riferimento ad una SAN. 

• License Server: attraverso questo modulo 
vengono gestite le licenze relative all'intera 
infrastruttura. 
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Per avere un'idea ancor più chiara di quanto si 
nasconda dietro questa serie di prodotti, ecco 
qualche accenno ad altri importanti concetti 
che, come riportato dai manuali ufficiali, co- 
stituiscono le componenti essenziali della Vir- 
tual Inf ras truc ture: 

• VirtualCenter Management Server: è il no- 
do di controllo per configurare, implementa- 
re e gestire gli ambienti virtualizzati. Il Man- 
agement Server è un servizio installato su si- 
stema operativo Windows 2000, Windows XP 
Professional o Windows Server 2003. 

• VirtualCenter Database: utilizzato per me- 
morizzare le informazioni persistenti sui ser- 
ver fisici, i resource pool e le virtual machine 
gestite da VirtualCenter Management Server. 
Il database che è possibile utilizzare può es- 
sere Oracle, Microsoft SQL Server o MSDE. 

• Virtual Infrastructure Client: permette agli am- 
ministratori di connettersi remotamente al 
VirtualCenter Management Server o diretta- 
mente sui server ESX da un qualsiasi PC con 
sistema operativo Windows. 

• VirtualCenter Agent: installato sui server ESX, 
permette la connessione da parte di Virtual- 
Center Management Server. 

• Virtual Infrastructure Web access: permet- 
te la gestione delle VM e l'accesso alla conso- 
le grafica delle VM senza la necessità di in- 
stallare un client. 

A questo punto, dopo una brevissima infarina- 
tura sui principali termini legati alla virtualiz- 
zazione secondo VMWare, cominciamo il no- 
stro cammino verso la costruzione di un'am- 
biente virtuale. 



L'INSTALLAZIONE 
DI VIRTUAL CENTER 

L'installazione di Virtual Center è caratterizza- 
ta da tre step principali: 

• Configurazione del DB che ospiterà le infor- 
mazioni. 

• Installazione della componente server di Vir- 
tual Center e del relativo License Server per la 
gestione delle licenze. 

• Installazione del Virtual Infrastructure Client 
necessario alle operazioni di configurazione 
dei server ESX e del server Virtual Center stes- 
so. 

Il primo passo da portare a termine, quindi, è 
l'installazione e configurazione del database, 
cuore delle informazioni che via via andranno 



a popolare questa base dati. Virtual Center 2, 
come menzionato poco fa, supporta Oracle, 
SQL Server e Microsoft MSDE. Facendo riferi- 
mento al solo caso di SQL Server, tutto quello 
che occorre fare, una volta definita una nuova 
istanza del DB in SQL Server e assicurati che 
tutte le tabelle siano riposte al suo interno, è 
quello di creare un nuovo SQL Server ODBC Con- 
nection inserendo poche semplici informazio- 
ni che "riportano" all'istanza SQL prima crea- 
ta. Una volta che questo passo è stato ultima- 
to, possiamo finalmente avviare l'installazione 
di Virtual Center (possibile purtroppo solo su 
macchine Windows) . 

Innanzitutto, assicuriamoci che la macchina 
che ospiterà Virtual Center, risponda ai seguenti 
prerequisiti: 

• Sistema operativo: Windows 2000 Server SP4 
with Update Rollup 1, Windows 2003 o Windows 
XP Professional. 

• Processore: 2.0GHz or superiore Intel or AMD 
x86. 

• RAM: almeno 2GB di RAM. 

• Spazio disco: Almeno 560MB di spazio disco 
libero (2GB consigliati), tenendo presente che, 
nel caso il DB sia locale, occorre una quan- 
tità superiore di spazio oltre a quella consi- 
gliata. 

Appurato questo, inseriamo il CD d'installazione e 
clicchiamo sulla voce VirtualCenter Management 
Server. Nel caso fosse necessario, ci verrà richiesto 
d'installare anche Microsoft .NET Framework ver- 
sion 1.1. Seguiamo le richieste del wizard e com- 
pletiamo l'installazione. 





Choose an iteni to instali: 

VirtualCenter Management Serv ar 
Virtual Infrastructure Client 
License Server 



a 



Explore the media 

Instali the VMware VirtualCenter Management Server componente. 



Figura 1: La schermata che appare inserendo il CD d'installazione di Virtual Center 
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A questo punto, considerato che abbiamo a di- 
sposizione il CD già inserito, clicchiamo sulla seconda 
voce della schermata principale, Virtual Infra- 
structure Client, che ci permetterà d'installare il 
tool per il collegamento non solo al Virtual Center, 
ma anche ai singoli host ESX. Tralasciamo per sem- 
plicità i dettagli di questo passaggio e accenniamo 
ora all'installazione del License Server. 
Anche qui valgono le stesse considerazioni fatte 
poc'anzi. Non occorrono consigli particolari: è suf- 
ficiente cliccare sulla voce License Server per dare 
inizio all'installazione di quest'altro componente. 
Terminate queste prime tre fasi, è il momento di 
dedicarci all'installazione di un host ESX, il cuore 
dell'infrastruttura sul quale si poggiano le singole 
macchine virtuali. 



INSTALLAZIONE 
DI Ul\l HOST ESX 

Innanzitutto, così come fatto per Virtual Center, 
occorre assicurarsi che l'hardware sul quale risie- 
derà questa componente, sia sufficientemente "do- 
tato" per consentirne l'installazione. Ecco i prere- 
quisiti richiesti: 

• Processore: almeno 2 processori di questo tipo: 

o 1500MHz Intel Xeon and later, or AMD 
Opteron (32À] bit mode); 

o 1500MHz Intel Viiv or AMD A64 x2 
dual_core processors; 

• RAM: almeno 1GB RAM. 

• Rete: una o più schede Ethernet. 

• Disco: uno SCSI disk, Fibre Channel LUN o RAID 
LUN con spazio non partizionato. 

Appurato anche in questo caso di possedere l'hardwa- 
re necessario a supportare il prodotto e verificata 
la connettività di rete, avviamo il nostro server con 
il CD d'installazione di ESX Server 3.01 inserito. 
Per semplicità, considereremo solo il caso di una con- 
figurazione con Storage locale, tralasciando gli al- 
tri casi. 

Appena dopo il caricamento del CD, ci viene mo- 
strata una schermata che ci chiede in che manie- 
ra procedere (fase GUIo TEXT dell'installazione). 
Diamo Invio per iniziare quella a modalità grafi- 
ca. Tralasciando i dettagli sull'installazione del 
mouse e "amenità" simili, clicchiamo su Instali (in 
luogo di Upgradé) quando ci verrà richiesto. Con- 
siderando che stiamo trattando l'installazione di 
un host ESX nuovo di zecca, possiamo procedere se- 



guendo le impostazioni predefinite (laddove pos- 
sibile) ed inserendo quelle "personali" (come l'in- 
dirizzo IP statico e la password dell'utente mot) 
quando richiesto. 

Al termine dell'installazione, il nostro ESX è pron- 
to ad ospitare le VM. Non resta quindi che colle- 
garci al singolo ESX o al Virtual Center tramite il 
Virtual Infrastructure Client per iniziare a "sma- 
nettare". In questa parte tralasciamo per motivi di 
spazio la parte relativa al licensing, rimandando 
questi dettagli sulla configurazione delle licenze 
alla documentazione VMWare. Pertanto, daremo 
per scontato che i server siano stati correttamen- 
te licenziati. 



CREAZIONE DI UNA 
VIRTUAL MACHINE 

Cominciamo col dire che solitamente, quando 
si decide di virtualizzare un certo numero di ser- 
ver, l'operazione che deve essere compiuta è 
quella di convertire una macchina fisica già pre- 
sente ed operativa in una macchina virtuale. 
Quest'operazione può essere compiuta attra- 
verso l'apposito tool gratuito offerto da VMWa- 
re e denominato Converter, oppure utilizzando 
appositi prodotti di terze parti a pagamento, co- 
me PowerConverter di PlateSpin. 
In questo articolo, non ci addentreremo in que- 
ste operazioni, ma focalizzeremo la nostra at- 
tenzione su alcuni concetti importanti del mon- 
do VMWare facendo vedere brevemente come 
costruire un macchina virtuale da zero. 
Avviamo dunque il client della Virtual Infra- 
structure e colleghiamoci al Virtual Center for- 
nendo l'indirizzo del server e le informazioni sul- 
le credenziali. Se non abbiamo commesso erro- 
ri, dopo pochi istanti si aprirà l'interfaccia prin- 
cipale del prodotto che ci permetterà di com- 
piere tutte le operazioni necessarie. 
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Figura 2: Aggiunta di un host ESX a Virtual Center 

Clicchiamo ora sul pulsante Inventory e sceglia- 
mo Host & Clusters. Poi clicchiamo ancora una 
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volta sulla voce Host & Clusters della root del- 
l'albero mostrato nel primo frame di sinistra e 
scegliamo New Datacenter. I datacenter sono 
contenitori logici per host ESX, Virtual machine, 
ecc. e ci servono per avere una visione globale 
di tutto più leggibile. Fatto questo, diamo il no- 
me che vogliamo a questa nodo dell'albero e con- 
fermiamo. Ora quello che occorre fare è inserire, 
all'interno del Virtual Center, gli host ESX che lo 
stesso dovrà gestire. Clicchiamo sulla voce del 
datacenter appena creato con il tasto destro del 
mouse e selezioniamo Add host. Inseriamo i da- 
ti sul nostro ESX per collegarci ad esso ed ag- 
giungerlo nell'elenco degli host da gestire. Ov- 
viamente ripetiamo l'operazione per tutti gli ho- 
st ESX da inserire. 

Adesso siamo pronti per creare una nuova Vir- 
tual Machine. L'operazione è, di per sé, molto 
banale, selezioniamo dal menu principale la vo- 
ce File, poi New ed infine Virtual Machine. Que- 
sti passi faranno partire un wizard tramite il qua- 
le potremo inserire le informazioni sulla VM che 
si sta creando, come il nome, la memoria, il nu- 
mero di schede di rete, ecc. Selezioniamo quin- 
di l'opzione Typical e procediamo inserendo i 
dati necessari. Si noti, in particolare, che questa 
fase non viene installato il sistema operativo, 
operazione questa che dovremo compiere al ter- 
mine della configurazione del wizard. 
Come "suggerito" dai manuali di VMWare, una 
virtual machine appena creata è esattamente 
identica ad una nuova macchina fisica con un 
disco rigido non formattato. 
Inseriamo dunque il CD del sistema operativo 
all'interno del lettore e, dopo aver modificato 
opportunamente le impostazioni della VM ap- 
pena creata (attraverso la voce Settings) in maniera 
tale da farle utilizzare il CDROM dell'host fisico, 
avviamola (tasto destro sulla VM e selezione del- 
la voce Power On) . 

In questa fase, vedremo l'avvio del BIOS della 
macchina e, successivamente, quello del setup del 
sistema operativo da installare. 
Da questo momento in poi, l'installazione è ana- 
loga a quella che effettueremo se avessimo una 
macchina "reale". 

Al termine, la macchina virtuale si comporterà 
esattamente come la sua "sorella" fisica: potremo 
raggiungerla via RDP oppure effettuare un ping 
ad essa, spegnerla o accenderla, ecc. In poche 
parole: la dovremo trattare come una macchina 
reale. 

In aggiunta a queste poche considerazioni pos- 
siamo anche dire che ogni macchina può essere 
facilmente clonata con pochi click di mouse o, 
addirittura, ne possiamo creare alcune come 
template da utilizzare come "base" per le prossime 
creazioni. 




Figura 3: Una macchina virtuale vista dal Virtual Infrastructure Client collegato ad 
un ESX 



CONCLUSIONI 

In questa brevissima panoramica abbiamo mo- 
strato in cosa possa consistere un ambiente vir- 
tuale secondo i canoni ed i vincoli offerti da 
VMWare. Ovviamente sarebbe comodo se tutto 
fosse sempre così semplice. In realtà, infatti, so- 
no stati volutamente tralasciati alcuni "ogget- 
ti" e concetti specifici di questo prodotto, sem- 
plicemente perché si voleva focalizzare l'atten- 
zione più sulla logica e sulle operazioni che sot- 
tintendono la virtualizzazione che sul prodot- 
to specifico. 

VMWare introduce diversi concetti per con- 
sentire un corretto uso delle risorse come i re- 
source pool, ad esempio. 

Inoltre, mediante moduli aggiuntivi, si può fa- 
re in modo da bilanciare il carico di lavoro in 
maniera automatica sugli host ESX coinvolti o, 
addirittura, prevedere lo spostamento delle VM 
(che in fondo altro non sono che una serie di fi- 
le) su un altro host ESX in caso di failure. In- 
somma: l'argomento è certamente molto vasto 
e non può essere certamente esaurito in poche 
pagine. 

Ogni nuovo concetto, anche solo menzionato, ci 
costringerebbe a dilungarci ulteriormente. Per- 
tanto, chiunque fosse interessato all'argomen- 
to, in special modo al prodotto offerto da VMWa- 
re, troverà sul sito di questa azienda tutta la do- 
cumentazione necessaria a muoversi in questo 
ambiente. 



Francesco Lippo 
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Zend Studio 5.5.0 



L'EDITOR "UFFICIALE" PER PHP 

PHP è uno straordinario linguaggio di 
programmazione che ha dalla sua 
parte una completezza fuori dal comu- 
ne, una curva di apprendimento bassis- 
sima, una velocità d'esecuzione non 
facile da trovare in un linguaggio 
interpretato.Normalmente si può scri- 
vere codice php persino utilizzando il 
notepad, ma ovviamente utilizzare un 
editor con caratteristiche avanzate 
migliora di molto la velocità di coding 
di qualunque programmatore.Zend 
Studio è un editor decisamente com- 
pleto prodotto dalla software house 
che più di ogni altra sponsorizza lo svi- 
luppo di PHP. Le funzionalità inserite 
sono tantissime, dalla navigazione fra 
le classi, al code complexion, alla sin- 
tax highliting, al tracing e al debug- 
ging dell'applicazione. Utilizzare questo 
strumento migliora facilita enormente 



la stesura del codice a qualunque pro- 
grammatore. 
Directory:ZendStudio-5_5_0a 




% ty Studio 



ir* 

il 

§ 



„ LICHT 



APACHE 2.2.4 

IL WEB SERVER PIÙ USATO AL 
MONDO 




L'ultima versione del Web Server pro- 
gettato da Apache e che da solo tiene in 
piedi una buona parte di Internet. 
Nonostante l'agguerrita concorrenza 
Apache rimane un Web Server incredi- 



bilmente usato. I suoi moduli sono pra- 
ticamente illimitati, è incredibilmente 
leggero, viene utilizzato praticamente 
su tutte le piattaforme di hosting al 
mondo. Se avete in mente di progettare 
un'applicazione Web non potete fare a 
meno di avere installato sulla vostra 
macchina in locale una versione di 
Apache. Quella che vi presentiamo è la 
versione 2.3 della serie 2, che ormai è 
sufficientemente consolidata da essere 
usata in ambienti di produzione. 
Directory:apache_2.2.3-win32-x86-no_ssl 

IRRLICHT 1.2 

ACCENDI IL MIGLIORE MOTORE 3D 
OPEN SOURCE! 

Irrlicht è un motore per la grafica tridi- 



mensionale, scritto in C++ e utilizzabile 
sia con questo linguaggio, sia con la tec- 
nologia .NET.Presenta le principali 
caratteristiche di un motore professio- 
nale e vanta una notevole comunità di 
sviluppatori, con diversi progetti in atti- 
vo. Irrlicht ha tra i suoi pregi anche 
quello di potere utilizzare sia DirectX 
che OpenGL per cui diventa particolar- 
mente adatto anche per lo sviluppo di 
giochi multipiattaforma 
Directory:irrlicht-1. 2.zip 

VISUALWX 087.6 

IL RAD PER LE WXWIDGETS 




Le WxWidgets sono una straordinaria 
libreria che consente di sviluppare 
applicazioni grafiche multipiattaforma 
in C++ con pochissimo sforzo. Unica 
pecca era fino a ieri l'assenza di un 
ambiente RAD per la costruzione delle 
form. Questa limitazione è adesso 
superata, infatti grazie VisualWX è ora 
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possibile disegnare con pochi colpi di 
mouse la propria applicazione per poi 
riempire di "contenuti" gli eventi asso- 
ciati ai vari elementi presenti sulla 
form.Si tratta di una comodità non da 
poco se si pensa a quanto facile sia svi- 
luppare per Windows e linux contempo- 
raneamente grazie proprio alle wxwid- 
gets 
D i rectory : Vi sua IWx_087-60.exe 

BAKEFILE 0.2.2 

IL GENERATORE DI MAKE 

In molti conosceranno l'utility "make". Si 
tratta semplicemente di un programmino 
che prende in pasto un file di testo e com- 
pila un software sulla base delle indicazio- 
ni in esso contenute, linkando le corrette 



Bak efile 



■• r*,i,i 



- — 



librerie e utilizzando un preciso ordine. 
Bakefile si sposa proprio con l'utility 
make. Prende in pasto infatti un file di 
descrizione e genera il corrispondente 
makefile. La novità è che bakefile è in 
grado di generare l'output corretto per un 
vastissimo numero di linguaggi. In sostan- 
za basta creare il file di descrizione per 
ottenere il makefile corretto per il proprio 
linguaggio di programmazione 
Di rectory :bakefi le-C2.2-setup.exe 

MiniGGW DEVELOPER 
STUDIO 2.0.5 

L'EDITOR PROFESSIONALE PER GCC 

GCC è uno splendido compilatore, 
veloce, affidabile e completo. Mancava 
fino ad oggi un editor che lo 
supportasse. Questa lacuna è colmata 
proprio da MingGW. Un ottimo 
prodotto che integra perfettamente 
tutte le caratteristiche di GCC. 
Assolutamente da provare 
Directory :MinGWStudioFullSetupPlus- 
2_05.exe 

CODEBLOCK 2007 

L'EDITOR MULTIPIATTAFORMA 
PER C++ 



m 




Code::Blocks è un IDE opensource cros- 
splatform. La particolarità di questo IDE è 
quello di essere modulare e basato su plu- 
gin. Supporta cioè una moltidutidne di 
linguaggi semplicemente aggiungendo il 
supporto corretto. Attualmente è orienta- 
to verso C++ ma con poco sforzo è utiliz- 
zabile proficuamente con ogni altro lin- 
guaggio / compilatore 
Di rectory :/boo 

MMIIMALISTIC GNU 
FOR WINDOWS 5.1.3 

GNU EVERYWHERE 

Una collezione completa di header file 
e librerie che vengono combinate con 
gli strumenti tipici GNU per produrre 
programmi nativi Windows utilizzando 
le librerie e i compilatori della famiglia 
GNU 
Directory:MinGW-5.1. 3.exe 

JAVA SE 
DEVELOPMEIUT KIT 6 

IL COMPILATORE INDISPENSABILE 
PER PROGRAMMARE IN JAVA 

Se avete intenzione di iniziare a 
programmare in Java oppure siete già dei 
programmatori esperti avete bisogno 
sicuramente del compilatore e delle 
librerie Java indispensabili. Sotto il nome 
di Java SE Development Kit vanno 
appunto tutti gli strumenti e le librerie 
nonché le utility necessarie per 
programmare in JAVA. L'attuale versione è 
la 6.0, ovvero la nuovissima release densa 
di innovazioni e molto più legata al 
desktop di quanto non fossero tutte le 
precedenti 
Directory:jdk-6-windows-i586 

TOMCAT 6.0.9 

IL SERVLET CONTAINER PER JAVA E 
JSP 

L'idea è molto semplice. Sviluppare im 
Java pagine Web. Ad un primo sguardo, 
Tomcat potrebbe sembrare un normale 
Web Server. Ed in effetti è un normale 
Web Server! In grado di soddisfare le 



richieste per qualunque pagina HTML. In 
realtà però Tomcat è anche qualcosa in 
più, ovvero la capacità di soddisfare le 
richieste per applicazioni Java. Potrebbe 
sembrare complesso, in realtà lo è meno 
di quanto sembri. Immaginate Tomcat 
come un grande contenitore al cui 
interno ci sono altri contenitori ciascuno 
dei quali rappresenta un'applicazione 
Java, che una volta richiamata costruisce 
una pagina Web interpretabile da un 
browser. Questo consente di sviluppare 
pagine Web utilizzando tutta la potenza 
della normale gerarchia delle classi Java e 
la sintassi e il linguaggio che qualunque 
programmatore Java conosce bene. 
Directory:apache-tomcat-6.0.9.exe 

ECLIPSE SDK 3.2.2 

L'IDE TUTTOFARE 

Eclipse è un progetto completo portato 
avanti da Eclipse Foundation con la 
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collaborazione di una miriade di aziende 
fra cui IBM, Adobe, Sun e che si è 
prefissata lo scopo di creare un IDE 
estendibile per plugin adattabile a 
qualunque tipo di linguaggio o 
tecnologia. Di default Eclipse si propone 
come IDE per Java ed è qui che da il 
meglio di se. Ma proprio grazie ai suoi 
plugin è possibile utilizzarlo come 
ambiente di programmazione per PHP, 
per C++, per Flex e per molti altri 
linguaggi ancora. Inoltre sempre grazie 
per ciascun linguaggio sono disponibili 
altri plugin ad esempio per rendere 
l'ambiente RAD o per favorire lo sviluppo 
dei Web Services o altro. Insomma lo 
scopo è stato raggiunto completamente. 
Eclipse è realmente un IDE tuttofare, 
ormai maturo, e che serve una miriade di 
programmatori grazie alle sue 
caratteristiche di affidabilità e flessibilità. 
Unica nota negativa: una certa pesantezza 
che lo rende idoneo ad essere usato solo 
su PC con una dotazione hardware 
minima di tutto rispetto 
Directory:eclipse-SDK-3.2. 1-win32.zip 
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PHP 5.2.1 

IL LINGUAGGIO DI SCRIPTING PIÙ 
AMATO DEL WEB 

Sono tre le colonne portanti di Internet: 
PHP, APACHE e MySQL. Certo la 
concorrenza è forte. Asp.NET e SQL Server 
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avanzano con celerità, ma a tutt'oggi non 
si può affermare che i siti sviluppati in 
PHP costituiscano la stragrande 
maggioranza di Internet. Quali sono le 
ragioni del successo di cotanto linguaggio? 
Prima di tutto la completezza. PHP ha di 
base tutto quello che serve ad un buon 
programmatore, raramente è necessario 
ricorrere a librerie esterne, e quando è 
proprio indispensabile farlo esistono 
comunque una serie di repository che 
rendono tutto immediatamente 
disponibile ed in forma gratuita. Il 
secondo punto di forza del linguaggio sta 
nella sua capacità di poter essere utilizzato 
sia in modo procedurale che nella sua 
forma ad oggetti certamente più potente e 
completa. Esiste un terzo di punta di forza 
essenziale che è quello riguardante la 
curva di apprendimento. PHP è in 
assoluto uno dei linguaggi con la curva di 
apprendimento più bassa nel panorama 
degli strumenti di programmazione. Si 
tratta perciò di uno strumento 
indispensabile per chi si awvicina alla 
programmazione web, a meno che non 
intendiate scegliere strade diverse quali 
possono essere ASPNET o JSP 
Directory:php-5.2.0-Win32.zip 



FRAMEWORK 0.9 

L'SDK EVOLUTO PER PHP 

Chi sviluppa in PHP è abituato a 
sviluppare in maniera autonoma il proprio 
framework, partendo dalle proprie 



esperienze e necessità. Questo ha però 
dato origine ad un ecosistema di 
applicazioni spesso difficilmente 
manutenibile. Zend ha sviluppato un 
proprio Framework completo che dispone 
di una serie di meccanismi che 
velocizzano la risoluzione dei problemi 
più frequenti. Si va dall'implementazione 
del pattern MVC alla creazione dei Web 
Services, alla gestione delle stampe in PDF. 
Si tratta di un framework piuttosto 
affidabile essendo sviluppato da Zend che 
è anche la software house promotrice 
dello sviluppo di PHP 
Directory:ZendFramework-0.9.1-Beta 

ZEND CORE O 

SISTEMA SEMPRE PERFETTO 

Il tuo sistema è abbastanza aggiornato? 
hai l'ultima versione di PHP con tutte le 



Zend 




ApKhtw ISWtbStrwr 



patch? Le applicazioni che girano sul tuo 
server soffrono di qualche bug di 
sicurezza?A tutto questo e a molto di più 
risponde Zend Core. Utilizzando questo 
prodotto sarete sempre certi di quale 
versione state utilizzando e della 
consistenza del vostro sistema. Si tratta di 
un tool veramente straordinario che 
consente ad ogni sistemista di dormire 
notti tranquille 

Directory:ZendCore-v2.0.3-Windows- 
x86.zip 

MYSQL 5.1.15 

IL PRINCIPE DEI DATABASE 

Indispensabile per programmare 
webapplication in tecnologia PHP Nonché 
non sia possibile utilizzare altridatabase, 
ma MySQL e PHP rappresentano 
veramente un binomioinscindibile. 
L'integrazione fra questo database e il 
linguaggio di scripting più usato sulla rete 
è talmente alta da fare divenire quasi un 
obbligo l'uso congiunto di questi due 



strumenti 

Directory:mysql-5. 0.27-win32.zip 

PYTHON 2.5 

L'EX GIOVANE RAMPANTE 

Python è stato considerato per lungo 
tempo il nuovo che avanza. Attualmente 
non lo si può più definire in questo modo, 
Python è ormai un linguaggio stabile e 
completo che trova applicazione inun 
gran numero di progetti. Se ne parla 
sempre di più in campo industriale come 
su Internet. Soprattutto un gran numero 
di applicazioni anche in ambiente 
Windows girano ormai grazie a Python e 
presentano interfacce grafiche 
ottimamente strutturate. Ciò nonostante 
Python rimane un grande linguaggio di 
scripting adatto a gestire in modo 
completamente automatico buona parte 
di un sistema operativo sia esso Linux o 
Windows 
Directory:python-2.5.msi 

POSTGRES 8.2.3 

IL GRATIS COMPLETO E VELOCE 

Nessun server di database offre la 
completezza delle funzioni esposte da 
PostgreSQL e rimane comunque 
completamente Gratis. PostgreSQL è 
probabilmente il più estendibile fra i 
database esistenti. Inutileparlare della 
gamma praticamente completa delle 
sue funzioni. Il punto di forza che lo 
pone probabilmente al di sopra di tutti i 
concorrenti rimane l'alta possibilità di 
personalizzazione, oltre, naturalmente, 
alla velocità, alla stabilità ed al costo 
nullo. Unica pecca, una certa 
complessità nella gestione. E' 
sicuramente da usare in ambienti di 
produzione professionali che non 
possono accontentarsi di alcun 
compromesso 
Directory :postgresql-8.2.1 -1.zip 
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PROGRAMMAZIONE 
DELLE ATTIVITÀ 

DOVETE RAGGIUNGERE UN OBIETTIVO. PER FARLO AVETE NECESSITÀ DI ORGANIZZARE 
UNA SERIE DI COMPITI ED ASSEGNARLI A DIVERSE PERSONE. CI SONO MILIONI DI MODI 
DI RAGGIUNGERE LO SCOPO. MA QUAL È QUELLO PIÙ EFFICACE? 



-0- 



Il tempo è una variabile che riveste un ruolo da pro- 
tagonista nello scheduling. Si vuole compiere un la- 
voro, eventualmente composto da più attività e 
utilizzando diverse risorse, umane o macchine, nel 
minor tempo possibile. È questa una prima defini- 
zione degli obiettivi che si prefiggono gli sviluppatori 
di algoritmi di scheduling. Tale definizione come ve- 
dremo potrà essere ampliata e approfondita giacché 
sotto questa etichetta si riconosce un'ampia casisti- 
ca di quesiti di ottimizzazione combinatoria costrui- 
ti per la ricerca di soluzioni ottime per problemi di 
programmazione di lavori. Nel presente articolo pro- 
veremo a trasmettere un esempio classico e ben cir- 
coscritto di scheduling, fornendo per esso le basi me- 
todologiche per risolverlo. Nella seconda parte, inve- 
ce, dopo aver esposto una serie di altri esempi, tente- 



1 


Attività elementare 

Rilevamento geologico, progettazione 
e preparazione cantiere 


Durata 
giorni 

30 


2 


Costruzione fondamenta 


12 


3 


Costruzione struttura (pilastri e solai) 


15 


4 


Erezione muratura vano 1 


1 


5 


Erezione muratura vano 2 


2 


6 


Erezione muratura vano 3 


1 


7 


Costruzione massetto e posa pavimenta- 
zione vano 1 


2 


8 


Costruzione massetto e posa pavimenta- 
zione vano 1 


2 


9 


Costruzione massetto e posa pavimenta- 
zione vano 1 


2 


10 


Fabbricazione copertura 


4 


11 


Intonacatura pareti vano 1 


2 


12 


Intonacatura pareti vano 2 


2 


13 


Intonacatura pareti vano 3 


2 


14 


Posa infìssi e porte vano 1 


1 


15 


Posa infìssi e porte vano 2 


1 


16 


Posa infìssi e porte vano 3 


1 


17 


Pittura vano 1 


1 


18 


Pittura vano 2 


2 


19 


Pittura vano 3 


1 


20 


Pulizia casa 


2 


21 


Consegna 


1 



remo nello spazio che abbiamo a disposizione l'ar- 
duo compito di sintetizzare lo stato dell'arte, affrontando 
terminologia e classificazione, in considerazione de- 
gli enormi progressi e degli innumerevoli contributi 
registrati in questi ultimi quaranta anni nella suddet- 
ta area di studio. 



COSTRUIAMO 
UNA CASETTA 

Per introdurci allo scheduling facciamo riferimento 
all'edilizia con un semplice esempio. Consideriamo 
il caso in cui si debba edificare una piccola costruzio- 
ne di tre vani. Si possono individuare delle attività ato- 
miche, nel senso che devono essere eseguite per in- 
tero, ognuna riferita ad un codice numerico (numerazione 
crescente) e ad una durata, che nel caso specifico può 
essere opportunamente espressa in giorni. In un pri- 
mo momento è necessario specificare le singole fasi che 
costituiscono l'intera attività (attività elementari), un 
modo per farlo è produne una tabella dove siano riportati 
i dati utili allo scopo, come esposto di seguito. 
Esistono dei vincoli di precedenza, ovvero al- 
cune fasi devono necessariamente essere eseguite 
dopo altre, ad esempio la costruzione della struttura 
di pilastri e solai non può che essere realizzata dopo la 
costruzione delle fondamenta. Cosicché l'attività n° 
2 è propedeutica alla n° 3. Un valido metodo per rap- 
presentare la gestione dei lavori del presente caso pre- 
vede l'uso di un grafo aciclico. I nodi del grafo conter- 
ranno le informazioni delle singole attività, ossia il nu- 
mero di riferimento e la durata, gli archi di congiunzione 
modellano il concetto di precedenza, come mostra- 
to in figura 1, dove è stato costruito il grafo per l'e- 
sempio proposto. 

La costruzione del grafo impone in questa tipologia 
di problemi la programmazione del lavoro, così biso- 
gnerà decidere i lavori che vanno serializzati, ossia po- 
sti uno dopo l'altro e quelli che invece possono esse- 
re svolti in "parallelo". Nel caso specifico, come si può 
dedurre dal grafo esistono diverse attività, attinenti i tre 
vani che si vogliono costruire, che possono essere rea- 
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Fig. 1: "grafo corrispondente al problema di programmazione dei lavori di un cantie- 
re per la costruzione di una piccola casa. " 



lizzate in contemporanea, basta avere la mano d'o- 
pera sufficiente; si tratta della pavimentazione, della 
pittura ed di altri. Inoltre, bisogna tener conto che il 
convergere di più archi su un solo nodo, implica che la 
sua realizzazione può essere solo successiva alla ter- 
minazione delle attività dei nodi che in esso immettono 
archi. Ad esempio, la copertura si può fare solo dopo 
la costruzione dei pilastri e dei muri. È evidente che il 
tempo totale per compiere i lavori si calcola come la som- 
ma delle durate per i nodi in serie, mentre, si conteg- 
gia il valore massimo per i rami in parallelo. Per l'e- 
sempio il tempo stimato perla realizzazione è 73 gior- 
ni lavorativi, il modello può prevedere anche dei ri- 
tardi. Il ritardo di alcune attività non inficia la conse- 
gna dei lavori, quindi il tempo totale, mentre in altre fa 
slittare la durata totale. Ad esempio, il ritardo di un 
giorno per la realizzazione del compito 11, "intona- 
catura vano 1 " non fa allungare la durata totale, men- 
tre uno stesso ritardo per il punto 20 ritarda il tutto. 



ALCUNI ESEMPI 

Di seguito sono riportati alcuni esempi per i quali la pro- 
grammazione di lavori può concretamente migliora- 
re l'efficienza dell'intero sistema. 
Esempio 1. Un ufficio postale, dove nel caso più ge- 
nerale vi sono più sportelli che servono più utenti. Si 
suppone che in base alla operazione da fare ogni uten- 
te conosca a priori il tempo di permanenza allo spor- 
tello. Inoltre, si ipotizza che un utente possa richiede- 
re il servizio di più sportelli. Infine, si può pensare che 
vi siano dei servizi a maggiore priorità di altri, per 
esempio il servizio telegrammi. È un caso in cui so- 
no note le attività e le risorse, rispettivamente i servizi 



OTTIMIZZAZIONE COMBINATORIA 



Si tratta di particolari problemi di 
ottimizzazione che trovano la 
soluzione nell'applicazione di 
strumenti del calcolo combinatorio. 
Si attua dove si hanno degli 
oggetti o più in generale entità che 
vanno disposte, combinati, 
permutate o assegnate tra loro. Il 
tipico esempio di problema di 



ottimizzazione combinatoria è 
knapsack ossia il ladro che avendo 
a disposizione un sacco di una 
determinata capienza si trova 
davanti al dilemma di quali oggetti 
rubare tenendo conto delle 
dimensioni e del valore di ogni 
oggetto, nonché ovviamente della 
capacità del sacco. 



richiesti dai clienti e gli sportelli. Ovviamente, tutti 
(ufficio e cittadini) hanno interesse affinché si ter- 
mini il prima possibile nel rispetto delle code e del- 
le priorità. 

Esempio 2. La CPU è una risorsa di straordinaria ef- 
ficienza e velocità, per questo è in grado di soddisfa- 
re le esigenze di più programmi, in termini più ge- 
nerici più processi. Uno dei compiti del sistema ope- 
rativo è trovare delle strategie per soddisfare le ri- 
chieste dei vari processi di utilizzo della CPU, nella mo- 
dalità multiprogrammazione. I processi possono ave- 
re diverse priorità. Si noti che i metodi più efficienti 
consentono di interrompere l'esecuzione di un pro- 
cesso per riprenderla poi, tale modalità è conosciu- 
ta come preemption. Qui le varie attività attingono ad 
un'unica risorsa. Si vuole ovviamente minimizzare 
il tempo di attesa di ogni singolo processo. 
Esempio 3. Una piccola azienda produce scatole per 
dolci di diversa dimensione e con diverse etichette. 
La catena di montaggio prevede quattro fasi che van- 
no realizzata in sequenza: taglio del cartone, piega- 
tura, stampa etichette e incollaggio. Ogni fase è as- 
sociata al lavoro di una macchina specifica. Anche 
qui l'obiettivo è minimizzare il tempo di produzio- 
ne, e quindi di non accumulare ritardi rispetto ai tem- 
pi previsti. 



TERMINOLOGIA 

Come accennato, in questi anni si è costruita una si- 
gnificativa teoria su questo argomento. Gli esempi 
proposti sono solo particolari tipi afferenti alla fa- 
miglia dello scheduling, in realtà le situazioni che 
possono presentarsi sono tante ed è quindi neces- 
sario produrre una vera classificazione oltre che stan- 
dardizzare il lessico da usare. Un modo più articola- 
to per definire i problemi di scheduling indica che: 
"bisogna svolgere un insieme di attività che attingo- 
no a più risorse, spesso scarse, in una quantità di 
tempo, ottimizzando una funzione obiettivo". Soli- 
tamente l'obiettivo è minimizzare il tempo. Nel- 
l'ambito della teoria dello scheduling le risorse sono 
indicate con il termine di provenienza industriale di 
macchine, mentre per le attività è uso comune fare 
riferimento a task. Importante è anche il concetto di 
job che indica più task in relazione tra loro. In al- 
tri termini più task (attività) possono costituire un 
unico job (lavoro), come nel caso dei sistemi ope- 
rativi dove più task possono costituire un proces- 
so. Due variabili sempre note sono il numero di 
macchine e il numero di job, indicate rispettiva- 
mente con m e n. Per il job si distinguono diversi 
tempi: 

Durata pij: tale tempo conosciuto anche come 
tempo di processamento, indica il tempo richiesto 
dalla macchina i per eseguire il task per il job j. Si 
tratta dell'i-esimo task del job j. Le durate sono 
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tempi certi, deterministici, e indicano dati sempre 
richiesti per il problema di scheduling. Come il sin- 
golo valore (costituito da due indici) suggerisce tali infor- 
mazioni possono opportunamente essere rappre- 
sentate con una matrice costituita da m righe e n co- 
lonne. 

Release date rj: è il tempo di rilascio che indica ri- 
spetto al tempo iniziale ti=0 quando è possibile co- 
minciare l'esecuzione del job. Spesso esistono dei 
tempi tecnici che non consentono la disponibilità di 
risorse per l'avvio di alcune attività. In tal caso un 
modo naturale per rappresentare queste informa- 
zioni è mediante un vettore di n elementi. 
Due date dj: è il tempo di consegna. Sempre rispetto 
al tempo iniziale ti=0 indica entro che tempo biso- 
gna terminare il job. È facile da associare proprio ai 
tempi di consegna postali, si indica cioè un termine 
entro cui va evaso l'ordine. Il non rispetto di tali sca- 
denze può comportare penali o rallentamenti del- 
l'intero sistema. Ovviamente, è necessario che in fa- 
se di progettazione ci sia una congruità tra i vari tem- 
pi descritti, il altre parole la durata di un job calcola- 
ta coma la somma delle durate dei singoli task som- 
mata a eventuali tempi di rilascio deve essere mino- 
re al più uguale del tempo di consegna. Anche qui 
un vettore è una giusta struttura da usare. 
Tempo di completamento Cj. È il tempo in cui termi- 
na il job j o analogamente il tempo che impiega l'ul- 
timo task del job j per terminare. I tempi sono riferi- 
ti al tempo iniziale ti=0 di avvio del processo. 
Di seguito sono riportati altri tempi che si calcolano 
dai fondamentali appena proposti. Essi esprimono in 
modo sintetico diverse esigenze delle scheduler. 
Lateness Lj. È la differenza tra il tempo di completa- 
mento e il due date ed è riferito al job j. Vale quindi Lj=Cj- 
dj. Esprime un ritardo se positivo, un anticipo se ne- 
gativo. Tardiness Tj. Questo indice è uguale alla Lateness 
nel caso di ritardo, ossia se Lj è positiva, zero altri- 
menti. Tj=max{0, Lj}. 

Oltre ai tempi esiste un altro elemento legato ai job di 
fondamentale importanza. Si tratta del peso (wei- 
ght) wj che indica rispetto ad una scala di valori l'im- 
portanza di un job. È utile usarlo qualora si imponga 
una sorta di priorità tra job o anche quando non si 
ha come unico obiettivo quello di minimizzare dei 
tempi, ma bensì quando si deve tenere conto di altri 
elementi del job opportunamente espressi dai pesi. 



il quale tutti i job richiedono la stessa macchina per 
essere eseguiti. Nel caso specifico un job non è scom- 
posto in attività elementari, è quindi ci si può indif- 
ferente riferire al job o al task. L'esempio più calzan- 
te di questa tipologia è proprio il sistema operativo mul- 
tiprogrammato a singola CPU, dove quest'ultima ri- 
sorsa che sappiamo essere indivisibile ma inter- 
rompibile viene assegnata ai diversi job (processi), 
per fissate quantità di tempo al fine di servire tutti i pro- 
cessi e di minimizzare il tempo medio di attesa di 
ogni processo. 

Flow shop. Il termine flusso suggerisce il funziona- 
mento del metodo. Le m macchine sono poste in se- 
rie e ogni job per essere eseguito sarà servito nell'or- 
dine da tutti i task associati alle m macchine, par- 
tendo dalla 1, poi passando alla 2 e così via. L'analo- 
gia questa volta richiama i sistemi produttivi a cate- 
na di montaggio tipici delle industrie automobilisti- 
che, dove l'auto inizialmente solo struttura, ossia me- 
ra scocca, viene passata alle innumerevoli macchi- 
ne, dove sono presenti operai o anche solo robot, che 
montano man mano le varie componenti dell'auto- 
mobile. 

Job shop. È questo il caso più generale. Qui non esi- 
ste un ordine precostituito di macchine da visitare. Cia- 
scun job può usare anche solo alcune macchine e 
nell'ordine che necessario. Ogni job può avere un 
suo ordine. Evidentemente si tratta di un caso più 
generale rispetto al precedente. L'esempio dell'uffi- 
cio postale afferisce a questo tipo di architettura. 
Vi sono molti altri elementi che caratterizzano un pro- 
blema di scheduling, mi limiterò ad indicare i più im- 
portanti al fine di avere un quadro d'insieme suffi- 
cientemente esaustivo. Una specifica che spesso si 
trova, come è accaduto nel nostro esempio della casetta, 
sono dei vincoli di precedenza. Ossia come è stato de- 
scritto nell'esempio per alcune attività devono essere 
rispettate delle propedeuticità; delle precedenze tra 
task, non si può costruire il tetto di una casa se non 
sono stati fatti i pilastri e i muri. Tali vincoli possono non 
solo coinvolgere i task di un singolo job ma anche ta- 
sk di diversi job o ancora differenti job. Il modo mi- 
gliore per descrivere le precedenze è usare un grafo 
così come è stato proposto nell'esempio. Un'altra spe- 
cifica è la preempition, il cui problema è conosciuto 
come preemptive. In alcune situazioni è consentito 
interrompere un job per eseguirne un altro più im- 




CLASSIFICAZIONE 
E SPECIFICHE 

La principale classificazione dei problemi di sche- 
duling riguarda il sistema produttivo od organizzativo 
e l'uso che si fa delle risorse-macchine. A tale pro- 
posito si distinguono tre tipi di architettura dei si- 
stemi: 
Macchina singola. È questo il caso più semplice per 
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osservati gli algoritmi di 
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operativi e quindi ad un campo di 
applicazione ben preciso, sebbene 
il più conosciuto. 



http://www.ioprogrammo.it 



Ottobre 2007/ 113 + 



lll-114:110-113-Soluzioni mcd 31-08-2007 16:28 Pagina 114, 



SOLUZIONI T ■ Algoritmi di schedulng 




-0- 



portante, I tempi di set-up uij, sono presenti in alcune 
realtà industriali ed indicano il tempo che la macchi- 
na i richiede per la propria configurazione e avvio (set- 
up) per poter eseguire il job;. Esistono macchine che 
servono a più scopi, per ognuno di essi possono es- 
sere richiesti tempi di avvio. Si pensi alle tanto diffuse 
stampanti multifunzione, a seconda delle operazio- 
ni che devono svolgere esistono dei tempi di avvio, ad 
esempio se si deve fare una scansione bisogna preve- 
dere i tempi di avvio del software per l'acquisizione. 
Alcune architetture hanno la specifica blocking o la 
più restrittiva no wait. Nel flow shop ogni macchina 
solitamente dispone di un buffer, può capitare che il 
buffer della macchina i sia pieno così il job corrente è 
costretto a fermarsi inattivo sulla macchina prece- 
dente i-1, favorendo così l'effetto indesiderato di riem- 
pire più rapidamente anche questo buffer; rallentan- 
do quindi l'intero processo produttivo. Si pensi al ca- 
so di una catena di montaggio per la costruzione di 
auto, se in un punto della catena si verificano proble- 
mi (forzata indisponibilità dell'addetto, guasto della 
macchina, pezzo da montare non idoneo, etc) gli altri 
job che dopo un po' di tempo arrivano allo stesso pun- 
to per essere trattati dovranno attendere in apposite aree 
di sosta o lungo la catena. Tali spazi sono limitati e se 
si saturano la macchina precedente non potrà passa- 
re il suo lavoro al nodo bloccato e incomincerà a intasare 
il proprio buffer. Esistono dei tipi di flow shop conosciuti 
come no -wait per i quali non sono previsti neanche 
dei buffer sulle singole macchine, cosicché un interruzione 
di una qualsiasi macchina in breve tempo paralizza 
l'intero processo. 



pò ti=0 inizio del processo di schedulazione. Sinte- 
ticamente si scrive max{Cl, C2, . . ., Cn}. 
Max Lateness Lmax. È il valore massimo tra tutti i ritardi 
degli n job. Se il sistema è particolarmente efficiente po- 
trebbe essere anche un valore positivo cioè un antici- 
po, in tal caso tra tutti si sceglie il minore anticipo. Sin- 
teticamente max{Ll,L2,..,Ln}. 
Max Tardness Tmax : max{0, Lmax}. 
Somma peseta dei tempi di completamento. È la som- 
ma ponderata tra pesi e tempi di completamento. Può 
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essere espressa come la sommatoria sugli n job. 
è il primo caso in cui nella funzione obiettivo compa- 
re oltre al tempo un altro parametro che stima altri 
aspetti, nel caso specifico "l'importanza" dei job. Ov- 
viamente, per tutte queste funzioni l'obiettivo è: mi- 
nimizzarle. Terminiamo specificando i modi in cui si 
può esprimere il problema di programmazione dei la- 
vori. Per farlo si possono riportare tre valori. Il primo 
denota il tipo di scheduling tra i tre elencati: macchi- 
na singola, flow shop e job shop indicati rispettiva- 
mente con 1, F e J. Il secondo rileva ulteriori caratteristiche 
del sistema come eventuali vincoli di precedenza, set- 
up, preemption e così via; infine l'ultimo parametro 
specifica la funzione obiettivo usata. Per i tre esempi 
fatti nel secondo paragrafo si distinguono tre diverse 
triplette che distinguono tre diversi problemi di sche- 
duling. 



OBIETTIVI 

L'obiettivo è trovare una soluzione ottima ad un pro- 
blema di programmazione dei lavori. Una qualsiasi 
soluzione, anche non ottima, è uno schedule. Con 
questo termine quindi si indica una descrizione com- 
pleta dell'assegnamento temporale dei task di tutti 
i job alle macchine che essi richiedono. Nel caso 
preemptive bisognerà indicare anche le interruzioni 
specificando per ogni task interrotto i tempi di so- 
spensione e riavvio. Nello schedule si indicano an- 
che i tempi di inizio di ogni task. Qualora tali tempi 
non siano specificati, ma si indichino solo i task si 
parla semplicemente di sequenza. Sinteticamente 
uno schedule si denota con S, mentre S(j) specifica il 
tempo di inizio del job j per lo schedule S. Le funzio- 
ni obiettivo tengono conto delle variabili, dei tempi 
e delle specifiche che abbiamo sinora descritto. 
Makespan Cmax. È il conosciuto massimo tempo di 
completamento e con riferimento ad uno schedule 
S indica il massimo tempo di completamento tra gli 
n job eseguiti. In altri termini è il job che termina per 
ultimo, che coincide quindi con il completamento 
di tutti i job. È una misura di tempo rispetto al tem- 



7=1 

n 

• 1, preemption, y W C ' ■ 

7=1 
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• F,setup, 2>7 T 7 



7=1 

Il caso della casetta può essere invece descritto come: 
• 1, vincoli di precedenza, Cmax 



CONCLUSIONI 

Lo scheduling comecomprende una ricca famiglia di 
problemi che possono essere affrontati con metodi 
consolidati e standardizzati. Nel prossimo appunta- 
mento esamineremo alcuni degli algoritmi più usati ol- 
tre che più efficienti tracciando così una percorso me- 
todologico per affrontare queso tipo di problemi. 

Fabio Grimaldi 
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